Skip to main content

Linear

The Linear integration automatically creates PRs from Linear issues assigned to Nimbus or labeled with nimbus.

Create a Linear webhook​

  1. Go to your workspace Settings → API → Webhooks
  2. Click New webhook
  3. Set the URL to https://api.get-nimbus.com/linear/webhook
  4. Set a secret — save this for your .env
  5. Subscribe to Issue events (created, updated)

Map Linear teams to GitHub repos​

POST to the /linear/teams endpoint to tell Nimbus which GitHub repo corresponds to each Linear team:

curl -X POST https://api.get-nimbus.com/linear/teams \
  -H "X-API-Key: $NIMBUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "linear_team_id": "TEAM-abc123",
    "github_repo_url": "https://github.com/acme/api",
    "workspace_id": "your-workspace-id"
  }'

View current mappings:

curl https://api.get-nimbus.com/linear/teams \
  -H "X-API-Key: $NIMBUS_API_KEY"

Triggering from issues​

Via assignment​

When a Linear issue is assigned to a user named nimbus (or your configured trigger name), Nimbus picks it up automatically.

Via label​

Apply the nimbus label to any Linear issue. Nimbus will read the issue title and description as the task, run it against the mapped GitHub repo, and open a PR.

Results in Linear​

When Nimbus completes a task, it posts a comment on the Linear issue:

Nimbus  ·  PR opened

https://github.com/acme/api/pull/143

Changes:
  - api/routes/users.py: added rate limiting with token bucket
  - tests/test_users.py: 3 new tests for rate limit behavior

Verification: pytest 47/47 passed

The issue is then moved to In Review status (configurable).