Your agent can start repository work from a Linear Issue or Project, then refresh it later with changes you confirm.
Install
Section titled “Install”You need agentbundle first. Install the credentials pack first, then this one, once for your user account:
agentbundle install --pack credential-brokersagentbundle install --pack linearIn Claude Code you can install it as a plugin instead:
claude plugin install linear@agent-ready-repoThen say “set up credentials” and type a Linear personal API key when prompted. The key never goes in a request or a repository file.
What your agent can do
Section titled “What your agent can do”- Read a Linear Issue, sub-issues, Project, Cycle, view, or a selection across repositories, starting read-only.
- Turn it into the right local artifact. Content decides whether it becomes an intent, brief, spec, defect, or separate units. Linear types and labels are only hints.
- Read an Issue or Project directly, and check your credentials.
- Refresh a tracked artifact and show you the field-by-field delta before anything local changes.
- Write one coordination change back to Linear, such as a trace link, status update, comment, or closure, after you confirm it.
Skills
Section titled “Skills”linear-brief-intake— Brings Linear work into the repository’s intake route.linear-brief-sync— Catches a brief up with its linked Linear Issue, through the refresh route.linear— Reads Issues and Projects through the Linear API and runs confirmed write-back actions.
Works with
Section titled “Works with”Works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and Kiro IDE. Install Credential Brokers first for your key. It hands its records to work-intake in Core. Other trackers: GitHub and Atlassian. See Connect your tracker and Use work intake.
Questions
Section titled “Questions”Will intake change anything in Linear? No. Intake never writes to Linear.
What if the artifact is being built? Requirement refresh is unavailable while the artifact is executing.
Does it retry a failed write? No. A remote change is never retried automatically, and each one needs a fresh confirmation.
Details
Section titled “Details”Scope: user (default), repo · Version: 0.3.3 · Source: packs/linear