Linear Integration

Connect ElasticClaw to Linear to sync agent tasks with your team's issues and projects.

How it works

ElasticClaw uses the Linear API to read and update issues. When an agent is created with a Linear ticket linked, it can:

  • Read the issue title, description, and comments
  • Post progress updates as issue comments
  • Move issues through workflow states (e.g., In Progress → Done)
  • Link PRs back to Linear issues

1. Create a Linear API Token

  1. Go to Linear → Settings → API → Personal API Keys
  2. Click Create key, give it a name like "ElasticClaw"
  3. Copy the token — you won't see it again
bash
export LINEAR_API_TOKEN=lin_api_xxxxxxxxxxxxx

2. Find Your Team ID

Query the Linear GraphQL API to get your team's ID:

bash
curl -s -H "Authorization: ${LINEAR_API_TOKEN}" \
     -H "Content-Type: application/json" \
     -d '{"query": "{ teams { nodes { id name } } }"}' \
     https://api.linear.app/graphql | jq '.data.teams.nodes'

Copy the id for your team.

3. Configure hub.yaml

yaml
integrations:
  linear:
    token: ${LINEAR_API_TOKEN}
    team_id: ${LINEAR_TEAM_ID}   # e.g. d513e4f1-4d0c-463e-b9a1-200d2f628309

Linking an Agent to a Ticket

When creating an agent, pass a Linear issue ID:

bash
elasticclaw create \
  --name fix-login-bug \
  --template my-template \
  --linear-issue ENG-1234

The agent will read the issue on startup and post updates as it works.

Linear API tokens have full read/write access to your workspace. Use a dedicated service account for production deployments.