agentify issue-killer

Labelled GitHub issues into supervised tmux worktrees.

Pulls open issues by label, creates an isolated git worktree per issue, and launches the configured agent provider in a tmux pane. Implemented in src/core/issue-killer.js:438 · runIssueKiller(root, config, args).

flags next: planning
module src/core/issue-killer.js default label agentify-ready limit cap MAX_LIMIT = 10
flags

Flags and defaults.

Constants below are exact values from src/core/issue-killer.js:11–16.

--labels

CSV of GitHub labels. Default agentify-ready (DEFAULT_LABEL). Splits via splitCsv.

--limit

Max issues per run. Default 5 (DEFAULT_LIMIT); maximum 10 (MAX_LIMIT). Non-positive integers throw.

--issue-provider

Currently only github (SUPPORTED_ISSUE_PROVIDERS). gitlab and azure-devops are reserved.

--agent-provider

Either codex or claude (SUPPORTED_AGENT_PROVIDERS).

--branch-prefix

Prefix for issue branches (e.g., issue/). Branch name is derived from the issue number and slugified title.

--bypass-permissions

Default true. Pass --bypass-permissions=false to require confirmation before each pane.

--root / --json / --dry-run

Standard flags. --dry-run reports the planned worktrees and prompts without executing.

behavior

What the command does.

fetches issues Calls GitHub via gh CLI, filtered by labels, capped at the resolved limit.
creates worktrees One isolated git worktree per issue, branched off the active base branch.
builds prompts Provider prompt is built via buildProviderTemplateCommand with the issue body + repo context.
launches tmux panes Default session name gh-issue-killer (DEFAULT_SESSION_NAME); one pane per issue.