Skip to content

Linear

PerSQL gives each Linear issue its own isolated SQLite branch database — the scratch space an agent needs to work a ticket. The branch spawns when the issue is created and is cleaned up when it’s done.

  1. Go to linear.persql.com/install/start, authorize the app, and connect your team to your PerSQL workspace.

  2. From then on, every new issue gets a schema-only branch database named issue-<team>-<n> (for example issue-eng-142).

Point a coding agent at the Linear MCP for the per-issue recipe:

https://linear.persql.com/mcp

Authenticate with a PerSQL bearer token. issue_recipe returns the snippet that spawns or resets the issue’s branch; issue_list shows the active ones. The agent reads and writes that branch as it works the ticket:

import { PerSQL } from "@persql/sdk";
const db = new PerSQL({ token: process.env.PERSQL_TOKEN })
.database("<namespace>/issue-eng-142");
await db.query("SELECT count(*) AS n FROM sqlite_master");

When the issue transitions to done, the branch is dropped.