Skip to content

Repository files navigation

Logseq Linear logo

LinSeq

Link issues, post comments, and track sprints — directly from your Logseq journal.


Install

  1. Search "LinSeq" in the Logseq plugin marketplace (Plugins > Marketplace) and click Install.
  2. Go to Plugins > Linear > Settings and paste your Linear API key.
  3. Set your Default Team (e.g. AI, EDA, SW).
Manual install (from source)
git clone https://github.com/pihalf/linseq.git
cd logseq-plugin-linear
npm install && npx vite build

In Logseq: Settings > Advanced > Developer mode (on) → Plugins > Load unpacked → select the dist/ folder.

Commands

Slash commands

Type / in any block:

CommandWhat it does
/linearInsert an issue by ID (e.g. AI-690) with status, priority, cycle, due date, and PR link
/linear-my-issuesList all your assigned non-completed issues as TODO blocks
/linear-searchSearch issues by text
/linear-createCreate a new issue in your default team
/linear-doneMark the issue in the current block as Done in Linear
/linear-commentPost a comment on the issue in the current block
/linear-linkWrap an issue ID with the inline renderer macro

Keyboard shortcut

Cmd+Shift+L — insert an issue link (same as /linear).

Toolbar

The Linear icon shows a badge with your active issue count.

Inline renderer

Type {{renderer :linear, AI-690}} in any block for an inline badge with the issue title and a colored status dot.

Example workflow

Morning standup:

  1. Type /linear-my-issues to pull in your assigned tickets:
    - TODO [[AI-690]] - Investigation; Stimulus Direct to SV vs CocoTB?
    linear-status:: In Progress
    linear-priority:: No priority
    linear-project:: Nectar and Normal CLI
    linear-cycle:: Sprint 37 (ends 2026-04-11)
    linear-pr:: [AI-690: SV vs CocoTB comparison](https://github.com/...)
    
  2. Post an update: cursor on the issue → /linear-comment → type your message
  3. Close it out: /linear-done → flips TODO to DONE in Logseq and marks Done in Linear

Quick issue creation:

  1. While writing, realize something needs tracking
  2. /linear-create → "Fix flaky timeout in stimulus runner"
  3. Issue is created in Linear and linked in your journal

Block properties

Inserted issues include these queryable properties:

PropertyExample
linear-statusIn Progress
linear-priorityMedium
linear-due2026-04-15
linear-cycleSprint 37 (ends 2026-04-11)
linear-projectConductor
linear-prPR title

Query them with Logseq's built-in system:

{{query (property linear-status "In Progress")}}

Settings

SettingDescription
Linear API KeyYour personal API key (get one here)
Default TeamTeam key for new issues (e.g. AI, EDA, SW)
Show Status in BlocksAdd status/priority/cycle/PR properties to inserted blocks

Requirements

  • Logseq desktop app
  • Linear account with API key

License

MIT

About

Linear integration for Logseq — link issues, post comments, track sprints

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages