Skip to content
Back to search

toh-framework

Type one sentence, approve once, walk away — Toh Framework installs an AI build department (14 commands, 8 agents, 23 skills) into your project and keeps building, testing and fixing until it is verified done. Works in Claude Code, Cursor, Antigravity, Codex and ZCode.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wasintoh--toh-framework/badge.svg)](/listings/wasintoh--toh-framework)

HTML

<a href="/listings/wasintoh--toh-framework"><img src="/api/listings/wasintoh--toh-framework/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Interactive install (choose IDEs and language)
npx toh-framework install

# Quick install (Claude Code, English)
npx toh-framework install --quick

# Specific IDE only
npx toh-framework install --ide claude
npx toh-framework install --ide cursor
npx toh-framework install --ide antigravity
npx toh-framework install --ide codex
npx toh-framework install --ide zcode

# Multiple IDEs
npx toh-framework install --ide "claude,cursor,antigravity,codex,zcode"

# Legacy targets (off by default)
npx toh-framework install --legacy-gemini       # .gemini/ for Enterprise/GCP Gemini CLI
npx toh-framework install --legacy-cursorrules  # root .cursorrules for very old Cursor

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 421 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="docs/assets/toh-framework-banner.png" alt="Toh Framework" width="760" />
  3. </p>
  4. <h3 align="center">"Type Once, Have it all!" — AI-Orchestration Driven Development</h3>
  5. <p align="center">Approve once. Walk away. Come back to a finished, verified app.</p>
  6. [![npm version](https://img.shields.io/npm/v/toh-framework.svg?style=flat-square)](https://www.npmjs.com/package/toh-framework)
  7. [![npm downloads](https://img.shields.io/npm/dt/toh-framework.svg?style=flat-square)](https://www.npmjs.com/package/toh-framework)
  8. [![License](https://img.shields.io/npm/l/toh-framework.svg?style=flat-square)](https://github.com/wasintoh/toh-framework/blob/main/LICENSE)
  9. [![GitHub stars](https://img.shields.io/github/stars/wasintoh/toh-framework?style=flat-square)](https://github.com/wasintoh/toh-framework)
  10. **Toh Framework** installs an AI "build department" into your project: **14 slash commands, 8 specialist agents, and 23 skills** — configured for Claude Code, Cursor, Antigravity, Codex, and ZCode in one install. You type one sentence (like `/toh-vibe coffee shop management system`), approve once, and it plans, builds, tests, and fixes until the app is verified done.
  11. ```bash
  12. npx toh-framework install
  13. ```
  14. **If you don't write code:** you get one screen that asks for your idea in plain language and one "Go". No stack to choose, no config to fill in, no jargon to decode. The AI writes the plan as a checklist you can actually read, then works down it — building, running its own tests, fixing what breaks — and comes back when the thing is finished. If it gets stuck, it says which step and why, in a sentence.
  15. **If you do write code:** it's a plan-as-file loop your agent cannot fake its way out of. The backlog lives in `.toh/plan.md` as checkboxes, so any session in any of the 6 supported IDEs resumes exactly where the last one stopped. The orchestrator re-runs each task's checkpoint itself and must quote real output before ticking the box — "done" means a command exited zero, not that a model said so. Model routing keeps cost sane (haiku scaffolds and tests, sonnet builds, opus plans and reviews), and everything is generated from one source of truth, so nothing drifts between IDEs.
  16. Changed your mind? `npx toh-framework uninstall` shows you exactly what it will remove, keep, or edit — and asks first.
  17. 🌐 **Official Website:** [tohframework.dev](https://tohframework.dev)
  18. > 📖 **[🇹🇭 Thai Documentation](docs/README-TH.md)**
  19. ## 🆕 What's New in v2.2.0
  20. > **Codex gets a real team.** Every Toh agent now installs as a native Codex custom agent, the 14 workflows are native Codex skills, and the repo has its first automated test suite. This release started as [PR #3](https://github.com/wasintoh/toh-framework/pull/3) by [@pcbimon](https://github.com/pcbimon) — the first outside code contribution to Toh Framework.
  21. | Feature | What it means for you |
  22. |---------|----------------------|
  23. | 🤖 **Native Codex agents** | All 8 Toh specialists are installed as project-scoped Codex custom agents in `.codex/agents/*.toml`, generated from `.toh/agents/`. Codex can now delegate to `ui-builder`, `plan-orchestrator` and friends the same way Claude Code, Cursor and Antigravity already could. Verified live on Codex CLI 0.145.0: the agent spawned, ran read-only where its tool allowlist says so, and reported back through the Toh announce contract. |
  24. | 🎛️ **Your model, their effort** | The agent files deliberately carry **no `model` key** — every agent inherits the model of your session, so one `/model` choice governs the whole team and a future model rename never strands an install. Each role only sets its reasoning effort (`lightweight`, `implementation`, `planning`, `review`) from a new `modelIntent` frontmatter key. |
  25. | 🔏 **Ownership by hash** | `.codex/toh-framework.json` records the sha256 of every agent file Toh wrote. Edit one, or add your own, and it is never overwritten or removed — by reinstall or by `toh uninstall --ide codex`, which takes out only the native agent files Toh can prove are its own (backed up first). |
  26. ### Also in 2.2.0
  27. - 💲 **`$toh-vibe` on Codex** — the 14 workflows are native Codex skills: invoke one with `$toh-<cmd>` or browse with `/skills`. Plain `/toh-vibe ...` text still works, and AGENTS.md now tells Codex to hand a delegated agent a self-contained brief (a full-history fork is refused).
  28. - 🧪 **First test suite** — `npm test` runs 14 checks against real installs into a temp directory: layout, TOML shape, the single-writer rule for `.agents/skills/` across IDE order, your `config.toml` left untouched, ownership by hash, AGENTS.md idempotency and budget, both uninstall paths. It gates CI and every release.
  29. - 🧭 **Unchanged on purpose** — `.agents/skills/` still has one writer, an existing `.codex/config.toml` is still never modified, and Codex capabilities are still probed at install time rather than assumed.
  30. ## 🤖 Supported IDEs
  31. | IDE | Status | Notes |
  32. |-----|--------|-------|
  33. | 🧠 **Claude Code** | ✅ Full Support | Native subagents + skills preload, Stop hook, slash commands & shortcuts |
  34. | 📝 **Cursor (2.4+)** | ✅ Full Support | Native subagents (`.cursor/agents/`), skills via `.agents/skills/`, always-on rules |
  35. | 🛰️ **Antigravity CLI (agy) + IDE** | ✅ Full Support | `.agents/` rules + skills + workflows + subagents + Stop hook |
  36. | 🤖 **Codex** — CLI + Codex desktop app (ChatGPT app) | ✅ Supported | Compact AGENTS.md + repo-level skills + native agents in `.codex/agents/` |
  37. | 💠 **ZCode (Z.ai)** | ✅ Supported | AGENTS.md + `.agents/skills/` + native `/toh-*` in `.agents/commands/` |
  38. | 💎 **Gemini CLI** | 🏢 Legacy | Enterprise/GCP only, behind `--legacy-gemini` |
  39. ## 💡 Why Toh?
  40. **Toh** = **T**ype **O**nce, **H**ave it all!
  41. We believe **Solo Developers** and **Solopreneurs** should be able to build SaaS systems single-handedly without being an expert in every field.
  42. Toh Framework enables you to:
  43. - 💬 **Command in natural language** - No complex prompts needed
  44. - 🤖 **AI handles everything** - Breaks down tasks, calls agents, executes until done
  45. - 👀 **See results instantly** - No waiting, no answering questions
  46. - 🚀 **Production-ready** - Not just a prototype
  47. ### 📜 Previous Versions
  48. See [CHANGELOG.md](CHANGELOG.md) for complete version history.
  49. **Recent highlights:**
  50. | Version | Date | Key Feature |
  51. |---------|------|-------------|
  52. | v2.1.1 | 2026-08-26 | Repair release: updates keep your memory, Stop hooks respect a parked plan, Codex capabilities probed not assumed |
  53. | v2.1.0 | 2026-08-16 | Compatibility release: agy support, Codex un-truncated, Cursor native subagents, shared `.agents/skills` |
  54. | v2.0.0 | 2026-07-14 | One-Go Build, TOH LOOP, Design Identity, Auto-Resume |
  55. | v1.8.0 | 2026-01-11 | 7-File Memory System, Agent Announcements |
  56. | v1.7.0 | 2025-12-26 | Security Engineer, `/toh-protect` command |
  57. | v1.6.0 | 2025-12-18 | Claude Code Sub-Agents, Multi-Agent Orchestration |
  58. | v1.5.0 | 2025-12-05 | Google Antigravity/Gemini Support |
  59. ---
  60. ## ✨ Features
  61. | Feature | Description |
  62. |---------|-------------|
  63. | **One-Go Build** | `/toh-plan` → approve once → whole app built autonomously |
  64. | **TOH LOOP** | Builds, tests, and fixes itself until every task is verified DONE |
  65. | **`/toh` Smart Command** | Type anything, AI picks the right agents and models |
  66. | **Design Identity** | Per-project `DESIGN.md` + versioned AVOID-LIST — no "AI look" |
  67. | **Auto-Resume** | `.toh/plan.md` survives `/clear`, restarts, and IDE switches |
  68. | **Sub-Agents** | 8 specialized agents with model tiers per role |
  69. | **Auto Memory** | Context persists across sessions and IDEs |
  70. ---
  71. ## 📦 Installation
  72. ```bash
  73. # Interactive install (choose IDEs and language)
  74. npx toh-framework install
  75. # Quick install (Claude Code, English)
  76. npx toh-framework install --quick
  77. # Specific IDE only
  78. npx toh-framework install --ide claude
  79. npx toh-framework install --ide cursor
  80. npx toh-framework install --ide antigravity
  81. npx toh-framework install --ide codex
  82. npx toh-framework install --ide zcode
  83. # Multiple IDEs
  84. npx toh-framework install --ide "claude,cursor,antigravity,codex,zcode"
  85. # Legacy targets (off by default)
  86. npx toh-framework install --legacy-gemini # .gemini/ for Enterprise/GCP Gemini CLI
  87. npx toh-framework install --legacy-cursorrules # root .cursorrules for very old Cursor
  88. ```
  89. ## 🔄 Update to Latest Version
  90. ```bash
  91. # Method 1: Use npx (recommended - always gets latest)
  92. npx toh-framework@latest install
  93. # Method 2: If installed globally
  94. npm update -g toh-framework
  95. toh install
  96. ```
  97. > 💡 **Tip:** Reinstalling updates skills, agents, and commands without deleting your existing memory!
  98. ## 🧹 Remove It Again
  99. Changed your mind? One command takes Toh Framework back out — it shows you a plain-language
  100. preview first and asks before deleting anything.
  101. ```bash
  102. # See exactly what would happen — changes nothing
  103. npx toh-framework uninstall --dry-run
  104. # Remove Toh Framework (asks you to confirm first)
  105. npx toh-framework uninstall
  106. # Somewhere else? Point at the folder
  107. npx toh-framework uninstall -t /path/to/your/project
  108. # Also delete your plan, work log and project notes (a backup copy is saved first)
  109. npx toh-framework uninstall --all
  110. ```
  111. **What it will never do:**
  112. - **Your own files are never deleted.** Anything it cannot prove it installed is left in place and
  113. listed on screen, so you always know what is still there and where.
  114. - **Files you share with it are edited, not replaced.** `CLAUDE.md`, `AGENTS.md`,
  115. `.claude/settings.json`, `.agents/hooks.json` keep every line you wrote — only the Toh section or
  116. the Toh hook comes out. If it cannot tell which part is Toh's, it changes nothing and says so.
  117. - **Your plan and notes stay by default.** `.toh/plan.md`, `.toh/progress.md` and the memory folders
  118. are your project's work; they are only removed if you say yes to the extra question (or pass
  119. `--all`), and a copy is saved to `.toh-uninstall-backup/` first either way.
  120. - **Folders are only removed once they are empty**, so your own files inside them survive.
  121. Other flags: `-y, --yes` (skip the question, for scripts) and `--verbose` (list every single file
  122. instead of a per-tool summary).
  123. ---
  124. ## 🚀 Quick Start
  125. ### Claude Code
  126. ```bash
  127. # Open project with Claude Code
  128. claude .
  129. # Show all commands
  130. /toh-help
  131. # Smart command - AI picks the right agent
  132. /toh create a landing page with pricing section
  133. # Create complete project
  134. /toh-vibe coffee shop management system
  135. # Add UI
  136. /toh-ui Add a dashboard with sales charts
  137. # Add Logic
  138. /toh-dev Add form validation and API calls
  139. # Improve Design
  140. /toh-design Make it look professional
  141. # Test system
  142. /toh-test
  143. # Security audit
  144. /toh-protect
  145. # Deploy
  146. /toh-ship
  147. ```
  148. ### Cursor
  149. ```bash
  150. # Same commands, right in chat — the always-on rule teaches Cursor to recognize them
  151. /toh-vibe Create a meeting room booking system
  152. # Or a specific command
  153. /toh-ui Create a calendar page for room booking
  154. ```
  155. ### Antigravity (agy CLI or Antigravity IDE)
  156. ```bash
  157. # Start Antigravity CLI
  158. agy
  159. # Same commands
  160. /toh-vibe Inventory management system
  161. ```
  162. ### Codex — CLI and Codex desktop app (ChatGPT app)
  163. ```bash
  164. codex
  165. # Invoke a Toh workflow as a native Codex skill ($ + name), or browse with /skills
  166. $toh-vibe Inventory management system
  167. # Plain /toh-* text works too — AGENTS.md teaches Codex the full command set
  168. /toh-vibe Inventory management system
  169. ```
  170. The 8 Toh agents are also installed as native Codex agents in `.codex/agents/*.toml`
  171. (generated from `.toh/agents/`, ownership-tracked so your edits are never overwritten).
  172. They inherit the model of your session and carry only a reasoning-effort hint per role.
  173. ### ZCode (Z.ai)
  174. Open the project in the ZCode app, or run the bundled CLI:
  175. ```bash
  176. zcode
  177. # The 14 /toh-* commands are installed as real slash commands
  178. /toh-vibe Inventory management system
  179. ```
  180. Check what ZCode picked up at any time:
  181. ```bash
  182. zcode skills list # 37 project-scope skills
  183. zcode commands list # 14 /toh-* commands
  184. ```
  185. ---
  186. ## 📋 Available Commands
  187. | Command | Shortcut | Description |
  188. |---------|----------|-------------|
  189. | `/toh` | - | 🧠 **Smart Command** - Type anything, AI picks agent |
  190. | `/toh-plan` | `/toh-p` | 📋 **Plan** - Writes `.toh/plan.md`, approve once, builds to the end |
  191. | `/toh-vibe` | `/toh-v` | 🎨 **Create Project** - Complete app in one command |
  192. | `/toh-ui` | `/toh-u` | 🖼️ **Create UI** - Pages, Components, Layouts |
  193. | `/toh-dev` | `/toh-d` | ⚙️ **Add Logic** - TypeScript, Zustand, Forms |
  194. | `/toh-design` | `/toh-ds` | ✨ **Polish Design** - Professional, not AI-looking |
  195. | `/toh-test` | `/toh-t` | 🧪 **Test** - Auto test & fix until pass |
  196. | `/toh-protect` | `/toh-pt` | 🔐 **Security Audit** - Full security check |
  197. | `/toh-connect` | `/toh-c` | 🔌 **Connect Backend** - Supabase, Auth, RLS |
  198. | `/toh-line` | `/toh-l` | 💚 **LINE MINI App** (convert) |
  199. | `/toh-mobile` | `/toh-m` | 📱 **Mobile App** - PWA / Capacitor |
  200. | `/toh-fix` | `/toh-f` | 🔧 **Fix Bugs** - Systematic debugging |
  201. | `/toh-ship` | `/toh-s` | 🚀 **Deploy** - Vercel, Production ready |
  202. | `/toh-help` | `/toh-h` | ❓ **Help** - Show all commands |
  203. > On Claude Code the shortcuts are real registered commands (v2.1). Elsewhere they work as chat patterns the rule files teach the model to recognize.
  204. ---
  205. ## 🏗️ Tech Stack (Fixed)
  206. No decisions needed - optimized stack ready to go:
  207. | Category | Technology |
  208. |----------|------------|
  209. | Framework | Next.js 16 (App Router) + React 19 |
  210. | Styling | Tailwind CSS 4 + shadcn/ui |
  211. | State | Zustand |
  212. | Forms | React Hook Form + Zod |
  213. | Backend | Supabase |
  214. | Testing | Playwright |
  215. | Language | TypeScript (strict) |
  216. ---
  217. ## 🧠 Philosophy (AODD)
  218. **AI-Orchestration Driven Development:**
  219. 1. **Natural Language → Tasks** - Just describe what you want
  220. 2. **Orchestrator → Agents** - System calls the right specialists
  221. 3. **No Process Management** - You just receive results
  222. 4. **Test → Fix → Loop** - Auto-fix until everything passes
  223. ```
  224. User: "Create a coffee shop management system"
  225. Orchestrator:
  226. ├── 📐 plan-orchestrator → Analyze & plan
  227. ├── 🎨 ui-builder → Create all UI
  228. ├── ⚙️ dev-builder → Add logic
  229. ├── ✨ design-reviewer → Polish design
  230. ├── 🧪 test-runner → Test & fix
  231. ├── 🔐 security-check → Audit code
  232. └── ✅ Deliver working system!
  233. ```
  234. ### 🔁 Plan → Vibe Workflow
  235. The plan is a **file**, never chat state:
  236. - `/toh-plan` writes `.toh/plan.md` → you approve **once** ("Go") → the whole plan is built autonomously, verified checkpoint by checkpoint.
  237. - `/toh-vibe` resumes any unfinished plan: it reads `.toh/plan.md` first and continues from the first unchecked task — in any session, any IDE.
  238. Note: autonomous-loop *enforcement* is strongest on Claude Code (Stop hook, `/goal`, `/loop`) and Antigravity (deterministic Stop hook in `.agents/hooks.json`) — other IDEs follow the same loop as instructions, with checkbox-resume in `.toh/plan.md` as the recovery mechanism.
  239. **Unattended builds** — kick off a full build headless (Claude Code):
  240. ```bash
  241. claude -p "/toh-vibe coffee shop management system" --permission-mode acceptEdits
  242. ```
  243. ---
  244. ## 📖 Examples
  245. ### Create E-commerce
  246. ```
  247. /toh-vibe Online store with products, cart, and checkout
  248. ```
  249. ### Create Dashboard
  250. ```
  251. /toh-vibe Analytics dashboard with charts and date filters
  252. ```
  253. ### Create SaaS
  254. ```
  255. /toh-vibe Project management tool with teams and tasks
  256. ```
  257. ---
  258. ## 🎯 Target Users
  259. - **Solo Developers** - Build SaaS single-handedly
  260. - **Solopreneurs** - Create MVP to test market
  261. - **Startup Founders** - Prototype for investors
  262. - **Freelancers** - Deliver client work faster
  263. - **Students** - Learn modern web development
  264. ---
  265. ## 📊 Framework Stats
  266. - 🤖 **8 Sub-Agents** - Specialized for different tasks, installed natively on Claude Code, Cursor 2.4+, Antigravity, and Codex
  267. - 🎯 **14 Commands** - From planning to deployment
  268. - 📚 **23 Skills** - Comprehensive AI capabilities, shipped once to `.agents/skills/` for every IDE that reads the open standard `[NEW in 2.1]`
  269. - 🎨 **Design Identity** - Per-project DESIGN.md design identity + versioned AVOID-LIST
  270. - 📦 **15 Component Templates** - Ready-to-use premium components
  271. - 🌐 **6 IDEs** - Claude Code, Cursor, Antigravity (+ Antigravity CLI), Codex (CLI + desktop app), ZCode, Gemini CLI (legacy)
  272. ---
  273. ## 📚 Documentation & Guides
  274. | Guide | Where |
  275. |-------|-------|
  276. | 🇹🇭 Thai documentation | [docs/README-TH.md](docs/README-TH.md) |
  277. | Full version history | [CHANGELOG.md](CHANGELOG.md) |
  278. | All commands + cheatsheet | run `/toh-help` in your IDE |
  279. | Per-project guide (auto-generated) | `CLAUDE.md` / `AGENTS.md` / `.cursor/rules/` / `.agents/rules/` in your project after install |
  280. | The plan artifact | `.toh/plan.md` — your app's live checklist (open it anytime to see progress) |
  281. | Design contract | `DESIGN.md` at your project root — generated per project, edit it to steer the look |
  282. ---
  283. ## 🤝 Contributing
  284. Contributions are welcome! Please feel free to submit a Pull Request.
  285. ## 📝 License
  286. MIT License - see [LICENSE](LICENSE) for details.
  287. ## 👨‍💻 Author
  288. **Wasin Treesinthuros** (Innovation Vantage)
  289. - 🌐 Website: [tohframework.dev](https://tohframework.dev)
  290. - GitHub: [@wasintoh](https://github.com/wasintoh)
  291. - Email: dr.wasin@gmail.com
  292. ---
  293. <p align="center">
  294. Made with ❤️ for Solo Developers everywhere.
  295. </p>
  296. <p align="center">
  297. <strong>"Type Once, Have it all!"</strong>
  298. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.