Skip to main content

Synopsis

profclaw linear <subcommand> [flags]

Description

linear manages the profClaw Linear integration. Linear is a modern project management tool popular with engineering teams. Once connected, profClaw can watch for new issues, respond to status transitions, and assign agent tasks to work on Linear tickets.

Subcommands

SubcommandDescription
statusShow Linear connection and team status
connectConfigure Linear API key and team
disconnectRemove the Linear integration
teamsList connected Linear teams
sync <team>Manually sync issues from a team
issuesList synced Linear issues

linear connect

--token
string
Linear API key. Generate at linear.app/settings/api.
--team
string
Linear team ID or key to connect.

linear sync <team>

team
string
required
Team ID or key to sync issues from.
--state
string
Filter by issue state name (e.g., Todo, In Progress, Backlog).
--label
string
Filter by issue label.
--limit
string
default:"50"
Maximum issues to sync.

Examples

profclaw linear status

Automation Triggers

When connected, profClaw can respond to Linear webhooks:
EventAction
Issue.createDispatch agent task for new issues
Issue.updateTrigger on state change (e.g., “In Progress”)
Comment.createRespond to @profclaw mentions

Environment Variables

LINEAR_API_KEY=lin_api_...
LINEAR_WEBHOOK_SECRET=...