CONNECTOR · LINEAR
Your plan, pushed to Linear in one click.
A connector is the bridge to your issue tracker. This one turns a Ready plan into Linear issues: nested, ordered, estimated, and set for your dev team to pick up.
What lands where
Push a Plan and every part of it maps to something native in Linear. No copy and paste, no reformatting.
| In Plansmith | In Linear |
|---|---|
| Project | Project |
| Spec | Issue |
| Child Spec | Sub-issue |
| "Needs first" link | "Blocked by" relation between issues |
| Effort (Low · Med · High) | Estimate |
| Readiness (Rough · Shaping · Ready) | Workflow state. Every pushed issue lands in your team's default starting state today, ready to pick up. |
| Acceptance criteria checklist | Checklist in the issue description |
Three steps to a full board
- 1
Connect
Click Connect Linear and sign in with your Linear account, or paste an API key. The connection belongs to you, not your whole workspace, and takes about a minute. If your workspace requires an admin to approve new apps, send them this page.
- 2
Review
Pick the Linear project your Plan should land in, or let Plansmith create one. Before anything reaches Linear, you see a preview: how many issues, and where each Spec lands.
- 3
Push
One click. A confirmation appears: "Pushed 14 issues to Linear." Every Spec keeps a link to its issue, so you can jump straight from the plan to the board.
Questions, answered
- What happens if I push the same plan again?
- Plansmith remembers which issue belongs to which Spec. A re-push updates the issues for Specs that changed in Plansmith and creates issues for new ones. Issues for unchanged Specs are left alone, and issues your team created themselves are never touched.
- My Spec tree is four levels deep. What happens?
- It lands four levels deep. Child Specs become sub-issues at every level, wired to their direct parent.
- Who needs to connect Linear?
- Whoever clicks Push. Connections are personal, so a teammate who pushes needs their own. Everyone else can still plan, comment on Specs, and export, and they see the issues appear in Linear.
- Do I need Linear before I start planning?
- No. Plan first, refine until it's Ready, and export it as a document (Markdown) or a spreadsheet (CSV) in the meantime. Connect Linear whenever you want the one-click push.
Handed off, not handed back.
Explore other connectors: Jira · Asana · Radial · All connectors