Formic — AI-powered task manager that turns goals into shipped code. Orchestrates Claude Code & Copilot CLI with structured planning, parallel execution, and human review. 🐜
formic-demo.mp4
📺 Watch the demo video if the player above doesn't load.
AI coding agents are powerful but chaotic. Without structure, they skip planning, overwrite each other's files, and lose context mid-task. Formic adds a tech-lead layer — every task goes through briefing, planning, and review before code ships.
- 🏗️ Structured pipeline — Brief → Plan → Declare → Execute → Review
- 🔀 Parallel execution — multiple agents work simultaneously with file-lease concurrency
- 🎯 Goal decomposition — describe a high-level objective, the architect AI breaks it into subtasks
- 🛡️ Crash-resilient — atomic saves, rolling backups, auto-recovery from corruption
- 🖥️ 100% local — your code never leaves your machine
- Node.js 20+ and npm
- A supported AI agent CLI: Claude Code CLI or GitHub Copilot CLI
-
Install —
npm install -g @rickywo/formic -
Start the server — Run
PORT=8000 formic start, then open http://localhost:8000. -
Add a workspace — Open the workspace selector in the top-left and point it at your project repo directory.
- Brainstorm — Chat with the AI Assistant to refine your idea and explore the codebase.
- Create a Goal — The assistant crafts a structured task with clear requirements.
- Automatic decomposition — The architect AI breaks the goal into 3–8 child subtasks.
- Parallel execution — Agents execute tasks concurrently with file-lease safety (briefing → planning → declaring → running → verifying).
- Review & approve — When tasks land in the Review column, inspect the changes and approve. Your feature is ready.
- 🛡️ Crash-resilient board — atomic saves with rolling backups and auto-recovery
- ⚡ Smart stage skipping — detects existing artifacts and resumes where it left off
- 📊 Usage meter — track agent credit consumption in real-time
- 🔄 Resume from any step — re-run tasks without restarting from scratch
- 🪵 Full log replay — reconnect and see complete task history