Use this whenever there is a ticket, issue, task, bug, request, or anything to do in this repo. Handles everything end to end from issue to merged PR.

Use this for any ticket, issue, task, bug, or request in this repo — takes it from issue to done.

Finding, creating, claiming, and closing work items (beads)

Defines coding conventions, error handling patterns, async practices, logging standards, API response formats, and testing workflows for the Order Service — a FastAPI/Python microservice. Covers typed exception classes with FastAPI exception handler registration, structlog structured logging, Pydantic request/response models, and pytest-asyncio endpoint tests. Use when writing or modifying order endpoints, implementing order processing logic, adding error handling, or working with any file matching app/**/*.py or tests/**/*.py in the Order Service.

Managing rigs — add, list, status, suspend, resume

Sending and reading messages between agents

Routing work to agents with gc sling and formulas

API server and web dashboard — config, start, monitor

City lifecycle — status, start, stop, init

Managing agents — list, peek, nudge, suspend, drain

Quick read-only health check — session context, workspace mounts, tool availability, and task snapshot. Use when the user asks for system status or runs /status.

Show what this NanoClaw instance can do — installed skills, available tools, and system info. Read-only. Use when the user asks what the bot can do, what's installed, or runs /capabilities.

X (Twitter) integration for NanoClaw. Post tweets, like, reply, retweet, and quote. Use for setup, testing, or troubleshooting X functionality. Triggers on "setup x", "x integration", "twitter", "post tweet", "tweet".

Replace OneCLI gateway with the built-in credential proxy. For users who want simple .env-based credential management without installing OneCLI. Reads API key or OAuth token from .env and injects into container API requests.

Use when the user wants local voice transcription instead of OpenAI Whisper API. Switches to whisper.cpp running on Apple Silicon. WhatsApp only for now. Requires voice-transcription skill to be applied first.

Check for and apply updates to installed skill branches from upstream.

Efficiently bring upstream NanoClaw updates into a customized install, with preview, selective cherry-pick, and low token usage.

Run initial NanoClaw setup. Use when user wants to install dependencies, authenticate messaging channels, register their main channel, or start the background services. Triggers on "setup", "install", "configure nanoclaw", or first-time setup requests.

Review and resolve PR issues with Qodo - get AI-powered code review issues and fix them interactively (GitHub, GitLab, Bitbucket, Azure DevOps)

Install and initialize OneCLI Agent Vault. Migrates existing .env credentials to the vault. Use after /update-nanoclaw brings in OneCLI as a breaking change, or for first-time OneCLI setup.