Nanako0129

Pilotfish — AI skill for Claude Code

AI community

Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper models execute, verification guards quality.

How to install Pilotfish

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Nanako0129/pilotfish and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Pilotfish does

Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper models execute, verification guards quality. One-prompt install.

Alternatives in AI

  • Multi Execute — 执行 - 多模型协作执行 (Multi-Model Collaborative Execution) 1.9k ★
  • Fusion Plan — OMC interview (interactive) → 3-round Opus 4.8 + GPT-5.5 fusion deepening → concise .omc/plans/ output → revie 468 ★
  • Vibe Coding Toolkit — A curated, battle-tested AI-coding toolkit: Claude Code plugins, subagent orchestration, quality gates, and re 297 ★

README

pilotfish 🐟

Small, fast role agents handle volume work while the frontier main session keeps planning, approval, integration, and final judgment.

**pilotfish** is a multi-model orchestration policy for [Claude Code](https://code.claude.com). The [macOS and Linux Plugin beta](./install/PLUGIN-INSTALL.md) adds hook-based ambient activation; the global configuration install remains a legacy alternative. The policy uses the `opus` family for the main session, Sonnet and Haiku for bounded execution and reconnaissance, and fresh Opus contexts for risk-triggered review.

[繁體中文](./README.zh-TW.md)

Contents

Why

Most coding-session tokens are spent on search, repetitive edits, tests, and documentation rather than frontier judgment. pilotfish routes those bounded paths to cheaper roles while keeping the main session accountable and using fresh-context reviewers at material acceptance boundaries.

New installs default to the `opus` alias; Fable remains an explicit `/model fable` choice. This is a cost-aware default, not a claim that one model wins every task. The rationale and measurements live in [research](./docs/research.md), the [design notes](./docs/design.md), and [#23](https://github.com/Nanako0129/pilotfish/issues/23).

Host or use case Project
Claude Code global policy This repository
Claude Code with session-scoped GPT routing remora
Grok Build pilotfish-grok
Codex CLI pilotfish-codex

How it works

The Plugin beta packages the policy and namespaced roles under Claude Code's native Plugin lifecycle. The legacy global install uses these direct targets:

Layer Installed target Responsibility
Machine `~/