grackle

Spawn the ACP-variant runtimes (claude-code-acp / codex-acp / copilot-acp). claude-code-acp validated; it surfaces real tool failures that native claude-code can't. Run with /test-acp-runtime. Pairs with /launch-grackle.

Spawn and exercise the native `claude-code` runtime against a test server, including the model names that work and the synthetic-tool-result gotcha. Run with /test-claude-runtime. Pairs with /launch-grackle.

Spawn the `codex` runtime against a test server. Use model `gpt-5.5` (requires Codex SDK >= 0.135.0). Run with /test-codex-runtime. Pairs with /launch-grackle.

Spawn and exercise the `copilot` runtime against a test server. CRITICAL: gpt-4o does NOT work — use claude-sonnet-4.5. Run with /test-copilot-runtime. Pairs with /launch-grackle.

Investigates code bugs and files GitHub issues.

Pure coordinator that decomposes work and delegates to subagents.

Verifies a PR is fully mergeable (CI green, no unresolved comments, approved) then merges it.

Manages a Grackle task through its lifecycle until the PR is ready to merge.

Fetch all approved-for-grackle issues, filter out closed and already-in-progress ones, and suggest a prioritized ordering. Run with /backlog-prioritize.

Search the codebase by concept using semantic search, then drill into results with Grep/Read. Use when exploring unfamiliar code, tracing behavior, or answering "how does X work?" questions.

Create a PR with change files, screenshots, and issue linking. Run with /create-pr or /create-pr <ISSUE_NUMBER>.

Create a new GitHub issue with proper labels and epic assignment, then write a requirements spec for it. Run with /open-ticket "<title>" or interactively.

Automated PR fixup loop — syncs with main, addresses all Copilot review comments, and waits for CI to pass. Run with /pr-fixup or /pr-fixup <PR_NUMBER>.

Detect stale README content and screenshots, capture fresh screenshots from the live app, and draft README updates. Run with /readme-refresh.

Generate a Rush change file for the current branch, handling merge-commit false positives automatically. Run with /rush-change.

Set or remove a GitHub blocked-by relationship between issues. Run with /set-blocked-by <blocked#> <blocker#> or /set-blocked-by remove <blocked#> <blocker#>.

Set or remove a GitHub sub-issue (parent/child) relationship. Run with /set-parent <child#> <parent#> or /set-parent remove <child#> <parent#>.

Research a GitHub issue and write a detailed requirements specification into the issue body. Run with /write-spec <ISSUE_NUMBER>.

Finds or creates a GitHub issue and Grackle task for a piece of work, or recommends the next ticket from a backlog.

Searches the codebase by concept using semantic search. Use for exploratory questions about behavior, flow, or architecture rather than exact symbol lookups.

Launch the self-recording Grackle demo. Builds Docker images, cleans state, provisions environments, creates project/task, and starts the demo recording agent.