An AI-powered engineering cockpit for the terminal. Provider-agnostic, security-hardened, and built for complex, multi-agent workflows.
CodePilot transforms your terminal from a basic shell into a Strategic Engineering Environment. It combines the architectural reasoning of top-tier models, the context of Gemini, and the precision of Aider into a single, transparent interface.
- Hierarchical Task Tree — Visualize nested sub-agent activities and tool calls in real-time.
- Interactive Plan Mode (
^P) — Mandate architectural research and side-effect analysis before execution. - Proactive Search — Automatically grounds technical knowledge using real-time web search for unknown libraries or errors.
- Enterprise-Grade Security — Path Traversal Guards block any attempt to access files outside the project root.
- Git-Backed Reliability — Automatic "Task Checkpoints" allow for atomic session rollbacks via the
/revertcommand. - Massive Context Support — Native optimization for 2.5M+ token windows (Gemini 3.0).
- Pro-Shortcuts — Direct terminal access (
!command), context pinning (@file), and rapid undo (^Z).
Install CodePilot instantly into your terminal using any of these methods:
curl -fsSL https://raw.githubusercontent.com/yash113gadia/codepilot/master/scripts/install.sh | bashnpm install -g yash113gadia/codepilotRun CodePilot without installing it:
npx yash113gadia/codepilot chat- Setup your API Key:
codepilot setup- Start an interactive session:
codepilot chat- Or pipe in context directly:
cat error.log | codepilot chat --pipe "fix this"| Feature | Claude Code | Aider | CodePilot (Upgraded) |
|---|---|---|---|
| UX Model | Linear List | Diff Stream | Hierarchical Task Tree |
| Safety | MCP-based | User-manual | Native Path Guards + Git Checkpoints |
| Planning | Mandatory | Optional | Interactive Toggle (^P) |
| Logic | Anthropic Only | Multi-model | Multi-model (Agnostic Hub) |
| Context | 500k | ~200k (Mapped) | 2.5M+ (Full-Repo Native) |
| Shortcut | Action | Description |
|---|---|---|
^P |
Plan Mode | Toggle the interactive planning and research state. |
^Z |
Quick Undo | Revert the last file modification instantly. |
^L |
Clear | Wipe the current session history and clear the screen. |
! <cmd> |
Direct Bash | Execute a local shell command without LLM intervention. |
@ <file> |
Pin Context | Force the agent to read and prioritize a specific file. |
/revert |
Task Rollback | Use Git to revert all changes made in the current session. |
CodePilot uses a layered configuration system (.codepilot/config.yaml). Set your provider and model globally or per-project:
codepilot config set provider google
codepilot config set model gemini-3.0-pro-preview- Ink (React for CLI) - Stateful, interactive TUI.
- Vercel AI SDK - Provider-agnostic LLM abstraction.
- TypeScript - Type-safe agent logic.
- Git - Atomic task checkpointing and recovery.
- Yash Gadia (@yash113gadia)
MIT