Skip to main content

​
Configure Linear

JJHub can connect a Linear team to a JJHub repository in two ways:
  • UI: best when you want JJHub to drive the OAuth flow and team discovery for you.
  • CLI: best for scripted setup or when you already have the Linear team metadata and OAuth token.

​
Configure Linear in the UI

  1. Open Integrations in the JJHub UI.
  2. Open Linear Sync.
  3. Click Connect Linear.
  4. Complete the Linear OAuth flow.
  5. Choose the Linear team and JJHub repository.
  6. Click Connect Team.
JJHub now keeps the Linear OAuth credentials server-side during this flow. The browser only receives a short-lived setup handle plus the team metadata needed to finish configuration. After setup, the same page lets you review installed integrations, trigger an initial sync, and remove an integration.

​
Configure Linear in the CLI

Use jjhub extension linear install when you already know the target repo and the Linear team you want to connect. 
cat <<'EOF' | jjhub extension linear install \
  --team-id team_123 \
  --team-name "Platform" \
  --team-key PLT \
  --repo-owner alice \
  --repo-name demo \
  --repo-id 42 \
  --credentials-stdin \
  --expires-at "2026-03-12T00:00:00Z" \
  --actor-id linear-user-123
{"access_token":"YOUR_LINEAR_ACCESS_TOKEN","refresh_token":"YOUR_LINEAR_REFRESH_TOKEN"}
EOF
Required flags:
  • --team-id
  • --repo-owner
  • --repo-name
  • --repo-id
  • --credentials-stdin
Optional flags:
  • --team-name
  • --team-key
  • --expires-at
  • --actor-id
When --credentials-stdin is set, stdin must contain JSON with an access_token field and an optional refresh_token field.

​
Manage an Existing Integration

# List configured Linear integrations
jjhub extension linear list

# Trigger the initial sync for integration 7
jjhub extension linear sync 7

# Remove integration 7
jjhub extension linear remove 7
See the CLI command reference for the full command surface.