$git clone https://github.com/J-StaR-Films-Studios/VibeCode-Protocol-Suite---
| 1 | # Takomi |
| 2 | |
| 3 | <div align="center"> |
| 4 | <h3>🎯 Stop Wrestling With AI. Start Building With Purpose.</h3> |
| 5 | <p><em>The artisan's toolkit that transforms AI from chatbot to development partner — powered by the VibeCode Protocol</em></p> |
| 6 | </div> |
| 7 | |
| 8 | --- |
| 9 | |
| 10 | > **🎉 Rebrand Notice:** VibeSuite is now **Takomi**! |
| 11 | > If you're following tutorials that reference `vibesuite` or `VibeCode`, simply use `takomi` instead. |
| 12 | > Example: `npx vibesuite install` → `npx takomi install` |
| 13 | > The VibeCode Protocol lives on as the engine powering Takomi. |
| 14 | |
| 15 | --- |
| 16 | |
| 17 | ## 🚀 Quick Start (Recommended) |
| 18 | |
| 19 | ### Takomi Pi Harness |
| 20 | |
| 21 | ```bash |
| 22 | npm install -g takomi |
| 23 | takomi setup pi |
| 24 | cd my-project |
| 25 | takomi |
| 26 | ``` |
| 27 | |
| 28 | Optional global skills: |
| 29 | |
| 30 | ```bash |
| 31 | takomi setup skills |
| 32 | # First install defaults to Core Skills. |
| 33 | # Repeat installs default to Leave As Is so existing selections are not pruned accidentally. |
| 34 | # Custom opens a color-coded category TUI with expandable skill rows when a TTY is available. |
| 35 | # Optional Pi feature packs can also be managed later: |
| 36 | takomi setup pi-features |
| 37 | ``` |
| 38 | |
| 39 | Useful management commands: |
| 40 | |
| 41 | ```bash |
| 42 | takomi refresh # one-command update: Takomi + Pi/assets/skills |
| 43 | takomi status |
| 44 | takomi doctor |
| 45 | takomi setup all |
| 46 | takomi setup project |
| 47 | ``` |
| 48 | |
| 49 | Legacy commands like `takomi install pi`, `takomi sync pi`, `takomi upgrade`, and `takomi init` still work, but the simpler mental model is: **setup once, refresh when stale, run `takomi` to use it.** |
| 50 | |
| 51 | During `takomi setup pi` or `takomi setup pi-features`, Takomi offers optional Pi feature packs with recommended/manual/select-all/skip choices. Current defaults install **Takomi Interview** (`npm:@juicesharp/rpiv-ask-user-question`) so models can ask structured clarification questions. **Takomi Todo** (`npm:@juicesharp/rpiv-todo`), **Takomi Browser QA** (`npm:pi-chrome`), and **Takomi Doc Preview** (`npm:pi-markdown-preview`) remain opt-in. `takomi refresh` runs Pi's package updater so installed optional, custom, old, and new Pi packages are reconciled together. |
| 52 | |
| 53 | Takomi keeps `pi-subagents` installed as an internal runtime module, but setup/refresh now detects legacy raw Pi subagent activation (`npm:pi-subagents` in Pi settings or `~/.pi/agent/extensions/subagent`) and offers to disable it so models see `takomi_subagent` instead of two competing subagent tools. |
| 54 | |
| 55 | ### Context Manager |
| 56 | |
| 57 | Takomi now ships a Pi-native `takomi-context-manager` extension. It reduces prompt bloat with progressive context loading: |
| 58 | |
| 59 | - skill names are always visible, while descriptions and full `SKILL.md` files load only when needed |
| 60 | - `skill_manifest`, `skill_load`, `policy_manifest`, `policy_load`, and `context_report` tools expose context on demand |
| 61 | - `/takomi routing` remains the source of truth for model-routing policy |
| 62 | - `takomi_subagent` is guarded by routing-policy context and can recover from wrong-provider model choices |
| 63 | - `/context-report` shows prompt compaction, loaded skills/policies, blocked actions, model-routing corrections, and duplicate extension diagnostics |
| 64 | |
| 65 | `context_report` is context-manager-specific rather than a clone of Pi's Alt-C window. It restores its own hidden snapshots and Pi tool-result history after `/reload`/restart, and labels any remaining gaps instead of reporting fresh in-memory zeros as session truth. It supports `mode: "summary" | "verbose" | "problems"`; `verbose: true` remains a compatibility alias for `mode: "verbose"`. The `/context-report` slash command supports argument completions for `summary`, `verbose`, and `problems`. |
| 66 | |
| 67 | ### Option A: Global Install (Best for Multi-IDE Users) ⭐ |
| 68 | |
| 69 | Install once. Use everywhere. Your skills follow you across detected AI harnesses (Antigravity, Claude Code, Codex, Cursor, Kilo Code, Pi/shared Agent Skills, Windsurf): |
| 70 | |
| 71 | ```bash |
| 72 | # Using pnpm |
| 73 | pnpm dlx takomi install |
| 74 | |
| 75 | # Using npx |
| 76 | npx takomi install |
| 77 | ``` |
| 78 | |
| 79 | What happens next: |
| 80 | - 🔍 **Auto-detects** every AI harness on your machine |
| 81 | - 📦 **Creates your command center** at `~/.takomi/` |
| 82 | - 🧰 **Lets you choose Core, Present Custom, Custom, All, or Leave As Is for skills** |