TDD-disciplined task executor. The worker agent that implements individual tasks with test-first methodology. Returns structured SUCCESS/FAILED/BLOCKED results.
Use this agent when you need to review code for adherence to project guidelines, style guides, and best practices. This agent should be used proactively after writing or modifying code, especially before committing changes or creating pull requests. It will check for style violations, potential issues, and ensure code follows the established patterns in CLAUDE.md. Also the agent needs to know which files to focus on for the review. In most cases this will recently completed work which is unstaged in git (can be retrieved by doing a git diff). However there can be cases where this is different, make sure to specify this as the agent input when calling the agent. Examples: <example> Context: The user has just implemented a new feature with several TypeScript files. user: "I've added the new authentication feature. Can you check if everything looks good?" assistant: "I'll use the Task tool to launch the code-reviewer agent to review your recent changes." <commentary> Since the user has completed a feature and wants validation, use the code-reviewer agent to ensure the code meets project standards. </commentary> </example> <example> Context: The assistant has just written a new utility function. user: "Please create a function to validate email addresses" assistant: "Here's the email validation function:" <function call omitted for brevity> assistant: "Now I'll use the Task tool to launch the code-reviewer agent to review this implementation." <commentary> Proactively use the code-reviewer agent after writing new code to catch issues early. </commentary> </example> <example> Context: The user is about to create a PR. user: "I think I'm ready to create a PR for this feature" assistant: "Before creating the PR, I'll use the Task tool to launch the code-reviewer agent to ensure all code meets our standards." <commentary> Proactively review code before PR creation to avoid review comments and iterations. </commentary> </example>
Resolve git rebase conflicts during auto-merge. Bias: preserve both sides where compatible. Refuse on migration/secret/lockfile files. One-shot; must stage resolved files and emit JSON summary.
Full /impeccable pipeline executor. Synthesizes the shape brief from the /think design doc + per-task AC list, selects /impeccable stages per task content, runs production-readiness passes (craft/polish/critique/harden/audit/layout), classifies findings, and returns a two-tier verdict with deferred_findings for operator to parse.
Analyzes integration and journey test coverage for code changes. Use this agent when: reviewing code changes for test coverage gaps, checking if journey tests exist for features, verifying database assertions in tests. <example> Context: User is running /review on changes to attendance feature user: "Review my changes" assistant: "I'll launch the integration-test-analyzer to check test coverage for your changes." <commentary> The sigma-review skill orchestrates this agent to analyze test coverage specifically. </commentary> </example>
Repair a broken state. Routes to the fast one-fix-per-iteration loop with auto-revert (fix, default) or the scientific-method hypothesis loop (investigate). Use when: 'fix all errors', 'make tests pass', 'fix the build', 'debug this', 'investigate this failure'.
Send and receive cross-project messages between agents in different projects (send via `fno mail send --to-project`, drain/read via `fno mail`). Use when an LLM in one project (e.g. acme-backend) wants another project's agent (e.g. acme-web, acme-docs, acme-blog, marketing) to know about or react to something. Recipient daemons drain mail autonomously; only kind:question reaches a human.
Natural-language remote control for the `fno agents` worker mesh. Describe the outcome you want - spawn or hand off work, open an interactive discussion, message or inspect workers, drive a session, or stop it - and this skill resolves and runs the provider- and substrate-specific CLI command. It normalizes arguments, applies confirmation policy, and reports genuine receipts. Use when: 'spawn a worker for ab-XXXX', 'hand off this doc to codex', 'discuss the retry design with gemini', 'show my running agents', 'drive the reviewer', 'stop the billing worker'.
Multi-perspective feature completeness analysis and planning loop. Use when: 'audit feature', 'what's missing', 'feature completeness', 'gap analysis', 'discover features to build', 'plan all features'.
Self-improvement loop for the toolkit. Captures corrections passively (git post-commit, pre-commit verifiers, /insights tags) into ~/.fno/corrections.log, then runs a monthly review via a fresh Claude API call against the current rule text and surfaces patches the user triages in 20 minutes. Use when the user asks to review corrections, run an autocorrect review, triage proposed patches, install the autocorrect schedule, ingest /insights, check autocorrect status, or audit recurring mistake classes in the toolkit.
Matches all tools
Hooks run on every tool call, not just specific ones
Executes bash commands
Hook triggers when Bash tool is used
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Modifies files
Hook triggers on file write and edit operations
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Uses power tools
Uses Bash, Write, or Edit tools
Has parse errors
Some configuration could not be fully parsed
Has parse errors
Some configuration could not be fully parsed
Set a target and walk away. Say f[no] to mostly done.
I got tired of watching coding agents stop at "looks done." Claude, Codex, Gemini, all of them[^1]: they write the code, the diff looks right, they hand it back, and then it's on me to find out at 11pm that the tests were never green. So I said f[no].
I built the loop that doesn't stop there. It keeps going until the PR is merged and CI is actually green, and when it isn't sure what to build next it walks the backlog and works it out.
Claude Code is my hammer, and I see a shit ton of nails. So I kept swinging: I got it running across providers, then got a Claude agent and a Codex agent mailing each other across terminal panels while they worked.
Really, I built this to ship my own projects faster. One of them became a business. footnote is the part underneath all of it. The rest of this is what it does.
Agent integration - the /fno:* commands and the walk-away workflow. Each AI CLI installs its own integration; the Claude plugin also bundles the fno CLI (its postinstall puts it on your PATH in a new session), so you don't need a separate CLI install:
Claude Code: /plugin marketplace add bllshttng/footnote
/plugin install fno@footnote
Gemini CLI: gemini extensions install https://github.com/bllshttng/footnote
Codex CLI: codex plugin marketplace add bllshttng/footnote # then enable
Then configure with /fno:setup and point it at a feature:
/fno:target "add OAuth login"
CLI only - just the fno binary, for scripting, CI, or driving footnote yourself. This installs fno but not the /fno:* slash commands (those need the agent integration above, or run fno setup wizard, which offers to wire them into the agent CLIs it finds on your PATH):
curl -fsSL fno.sh | sh # one-liner
uv tool install fno # uv (or: pip install fno)
brew install bllshttng/fno/fno # homebrew
cargo install fno # cargo
Local-clone install and path configuration: docs/getting-started.md.
Configure a project from a Claude Code session with /fno:setup, or from the terminal with no agent:
fno setup wizard # asks the few real per-project decisions, writes them validated
# then offers to install the /fno:* integration for each agent CLI on your PATH
Read or edit any setting directly: fno config get|set|unset <key> (atomic and schema-checked). Defaults are sensible; you can skip straight to running.
Two ways to ship a feature; both end in a merged PR. Then scale up.
Autopilot. Point the target skill at a feature description or a backlog node, then walk away:
/target "add OAuth login" # think -> plan -> code -> review -> ship
/target fno-a3f9 # by backlog node id
It runs the whole loop with or without you watching, and prints the PR URL when it ships. You don't have to pass a size; it runs a sensible default.
Hands-on. Drive the design yourself, then hand off the build:
/think "OAuth login" # explore the design space
/blueprint "OAuth login" # plan it, then hands off to a fresh /target thread
/blueprint spawns the build in its own Claude Code thread so your planning context stays clean.
Keep going. /megawalk chews through the whole backlog until it's done or out of budget, walking the dependency graph to pick what ships next.
Loop harnesses together. Spawn an agent on another provider and work alongside it:
fno agents spawn reviewer "review the diff" -p codex # a Codex agent on this repo
fno agents ask reviewer "what did you find?" # message it; it works on its own
Each agent runs its own loop and they coordinate over a message bus. Claude, Codex, and Gemini, one project.
Also in the box:
/review.An orchestration loop for shipping software, packaged as a plugin. Most loops re-run a prompt or fire on a timer; this one won't let a session stop until external truth says so: the PR exists, CI is actually green, and every required reviewer has signed off with nothing blocking. It reasons over a dependency graph to decide what to ship next, and survives session compactions, provider hiccups, and your skepticism. No vibes-based "done."
Not a sandbox. Not a babysitter. Not a hero-video launch. It runs your plans with your credentials on your machine and assumes you meant what you asked for. docs/security-posture.md draws the trust boundary. Read it before you point this at anything you'd hate to hand a robot.
npx claudepluginhub bllshttng/footnote --plugin fnoLive conversation mirror - tail session transcripts in a split pane
Auto-save readable session transcripts before compact/clear wipes scrollback
Copy & export Claude Code conversation responses to clipboard or file
Harness-native ECC operator layer - 67 agents, 277 skills, 92 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses
Supergraph enforces a complete, evidence-based coding pipeline — scan → plan → TDD → fix → verify → review — grounded in real codebase analysis at every step. It combines AST dependency graphs, LSP-level code intelligence, and a structured skill chain so Claude never guesses about impact before making a change.
v9.52.0 - Reliability wave: tangle contextual review correction loop with hard round ceiling, progress-supervised review rounds (per-agent stall watch, descendant-tree kills), council diversity and agy pin fixes, marketplace generator source-of-truth fix, provider troubleshooting runbook and cost-expectations docs. Run /octo:setup.
Claude harness - A harness for solo developers (Vibecoders) to handle full-cycle contract development.
Persistent file-based planning for AI coding agents. Crash-proof markdown plans (task_plan.md, findings.md, progress.md) that survive context loss and /clear, with an opt-in completion gate and multi-agent shared state. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60+ agents via the SKILL.md standard. Includes Arabic, German, Spanish, and Chinese (Simplified and Traditional).
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques