The Orchestrator for Indie Builders using Gemini CLI
[ 🏠 Home ] | [ 🚀 Getting Started ] | [ ⚡ Power User Guide ] | [ 📖 Command Wiki ]
| 🚀 Start Here | 📖 Knowledge | ⚡ Advanced | 🤝 Community |
|---|---|---|---|
| Quick Install | Command Wiki | Saiyan Mode | Contribution |
| Getting Started | Sniper Model | SuperSaiyan Cycle | License |
KamiFlow is a rigorous, opinionated "Operating System" for Indie Hackers using Gemini CLI. It transforms the AI from a generic chatbot into a disciplined Technical Co-Founder.
Philosophy: "Aesthetics + Utility". Ship fast, break nothing important.
⚠️ Developer Note: Project restructured to standard monorepo. CLI docs inpackages/kamiflow-cli/docs/, architecture indocs/architecture/.
- 🎯 Sniper Model Workflow: A 3-step fused kernel (Idea → Spec → Build) with Recursive Clarify Score and Logic Drift Detection.
- 🛡️ v2.49+ High Discipline: Hard-gated specifications, automatic code-fact verification, and system-level constitutional locks.
- 🧠 Relational Knowledge Graph: Persistent SQLite-based project lineage and wisdom tracking for deep context recovery.
- 🚀 Unified Flow Orchestrator: A single command (
/flow) to manage the entire Sniper lifecycle from diagnostic to execution. - ⚡ Saiyan Automation Suite: "God Mode" automation (
/dev:saiyan) for autonomous execution and batch processing. - 🐝 Sub-Agent Swarm: Multi-threaded parallel execution with concurrency locks and specialized agent registry.
- 💡 Idea Sandbox (The Lab): A safe space to "draft" and "analyze" raw ideas using multiple AI personas.
- 🛠️ Self-Healing Core: Proactive system doctor and automated repair mechanisms.
- 🚀 Smart Installer: Frictionless installation with Basic/Full presets and safe ignore appending.
Smart Assistant: Our installers now include Pre-flight Checks to help you setup Node.js, NPM, and NVM automatically if they are missing.
Windows (PowerShell):
powershell -c "irmo https://raw.githubusercontent.com/kamishino/gemini-cli-workflow/main/install.ps1 | iex"MacOS / Linux / WSL (Bash):
curl -sSL https://raw.githubusercontent.com/kamishino/gemini-cli-workflow/main/install.sh | bashThis will automatically setup the kamiflow (alias kami) global command.
| Role | Command | Goal |
|---|---|---|
| Strategy | /kamiflow:dev:flow |
[v2.49] Orchestrate the entire lifecycle in one go. |
| Lineage | _insights --task |
[v2.49] Query the project's Knowledge Graph. |
| Recovery | /kamiflow:ops:wake |
Reload project memory at session start. |
| Fast-Track | /kamiflow:dev:superlazy |
[v2.0] Auto-generate artifacts with validation & reflection. |
| God Mode | /kamiflow:dev:saiyan |
[v2.0] Fully autonomous execution with auto error recovery. |
| Resume | /kamiflow:ops:resume |
[v2.0] Resume interrupted workflows from checkpoints. |
📖 View Full Command Wiki (17+ Commands)
KamiFlow uses a 3-step fused kernel to ensure implementation accuracy:
- Idea Phase: Diagnostic interview to find the root cause.
- Spec Phase: Schema-First technical specification.
- Build Phase: Detailed task breakdown with Legacy Code awareness.
Running into issues? Don't panic. Check our Troubleshooting Guide for common errors and fixes.
We welcome contributions from the community! Whether it's a bug fix, new feature, or documentation improvement.
- Fork the Repo.
- Create your feature branch.
- Submit a PR.
The KamiFlow name, logo, and related brand assets are protected. While the source code is licensed under MIT, you may not use the "KamiFlow" name or logo for derivative works, forks, or commercial products in a way that suggests endorsement by or affiliation with the original author (Toan Huynh).
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ for the 10x Indie Hacker.