AI build workflow harness for Claude Code and Cursor

"Type Once, Have it all!" — AI-Orchestration Driven Development

Approve once. Walk away. Come back to a finished, verified app.

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.

npx toh-framework install

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.

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.

Changed your mind? npx toh-framework uninstall shows you exactly what it will remove, keep, or edit — and asks first.

🌐 Official Website: tohframework.dev

📖 🇹🇭 Thai Documentation

🆕 What's New in v2.2.0

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 by @pcbimon — the first outside code contribution to Toh Framework.

Feature	What it means for you
🤖 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.
🎛️ 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.
🔏 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).

Also in 2.2.0

• 💲 $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).
• 🧪 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.
• 🧭 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.

🤖 Supported IDEs

IDE	Status	Notes
🧠 Claude Code	✅ Full Support	Native subagents + skills preload, Stop hook, slash commands & shortcuts
📝 Cursor (2.4+)	✅ Full Support	Native subagents (.cursor/agents/), skills via .agents/skills/, always-on rules
🛰️ Antigravity CLI (agy) + IDE	✅ Full Support	.agents/ rules + skills + workflows + subagents + Stop hook
🤖 Codex — CLI + Codex desktop app (ChatGPT app)	✅ Supported	Compact AGENTS.md + repo-level skills + native agents in .codex/agents/
💠 ZCode (Z.ai)	✅ Supported	AGENTS.md + .agents/skills/ + native /toh-* in .agents/commands/
💎 Gemini CLI	🏢 Legacy	Enterprise/GCP only, behind --legacy-gemini

💡 Why Toh?

Toh = Type Once, Have it all!

We believe Solo Developers and Solopreneurs should be able to build SaaS systems single-handedly without being an expert in every field.

Toh Framework enables you to:

• 💬 Command in natural language - No complex prompts needed
• 🤖 AI handles everything - Breaks down tasks, calls agents, executes until done
• 👀 See results instantly - No waiting, no answering questions
• 🚀 Production-ready - Not just a prototype

📜 Previous Versions

See CHANGELOG.md for complete version history.

Recent highlights:

Version	Date	Key Feature
v2.1.1	2026-08-26	Repair release: updates keep your memory, Stop hooks respect a parked plan, Codex capabilities probed not assumed
v2.1.0	2026-08-16	Compatibility release: agy support, Codex un-truncated, Cursor native subagents, shared .agents/skills
v2.0.0	2026-07-14	One-Go Build, TOH LOOP, Design Identity, Auto-Resume
v1.8.0	2026-01-11	7-File Memory System, Agent Announcements
v1.7.0	2025-12-26	Security Engineer, /toh-protect command
v1.6.0	2025-12-18	Claude Code Sub-Agents, Multi-Agent Orchestration
v1.5.0	2025-12-05	Google Antigravity/Gemini Support

---

✨ Features

Feature	Description
One-Go Build	/toh-plan → approve once → whole app built autonomously
TOH LOOP	Builds, tests, and fixes itself until every task is verified DONE
/toh Smart Command	Type anything, AI picks the right agents and models
Design Identity	Per-project DESIGN.md + versioned AVOID-LIST — no "AI look"
Auto-Resume	.toh/plan.md survives /clear, restarts, and IDE switches
Sub-Agents	8 specialized agents with model tiers per role
Auto Memory	Context persists across sessions and IDEs

---

📦 Installation

# 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

🔄 Update to Latest Version

# Method 1: Use npx (recommended - always gets latest)
npx toh-framework@latest install

# Method 2: If installed globally
npm update -g toh-framework
toh install

💡 Tip: Reinstalling updates skills, agents, and commands without deleting your existing memory!

🧹 Remove It Again

Changed your mind? One command takes Toh Framework back out — it shows you a plain-language preview first and asks before deleting anything.

# See exactly what would happen — changes nothing
npx toh-framework uninstall --dry-run

# Remove Toh Framework (asks you to confirm first)
npx toh-framework uninstall

# Somewhere else? Point at the folder
npx toh-framework uninstall -t /path/to/your/project

# Also delete your plan, work log and project notes (a backup copy is saved first)
npx toh-framework uninstall --all

What it will never do:

• Your own files are never deleted. Anything it cannot prove it installed is left in place and listed on screen, so you always know what is still there and where.
• Files you share with it are edited, not replaced. CLAUDE.md, AGENTS.md, .claude/settings.json, .agents/hooks.json keep every line you wrote — only the Toh section or the Toh hook comes out. If it cannot tell which part is Toh's, it changes nothing and says so.
• Your plan and notes stay by default. .toh/plan.md, .toh/progress.md and the memory folders are your project's work; they are only removed if you say yes to the extra question (or pass --all), and a copy is saved to .toh-uninstall-backup/ first either way.
• Folders are only removed once they are empty, so your own files inside them survive.

Other flags: -y, --yes (skip the question, for scripts) and --verbose (list every single file instead of a per-tool summary).

---

🚀 Quick Start

Claude Code

# Open project with Claude Code
claude .

# Show all commands
/toh-help

# Smart command - AI picks the right agent
/toh create a landing page with pricing section

# Create complete project
/toh-vibe coffee shop management system

# Add UI
/toh-ui Add a dashboard with sales charts

# Add Logic
/toh-dev Add form validation and API calls

# Improve Design
/toh-design Make it look professional

# Test system
/toh-test

# Security audit
/toh-protect

# Deploy
/toh-ship

Cursor

# Same commands, right in chat — the always-on rule teaches Cursor to recognize them
/toh-vibe Create a meeting room booking system

# Or a specific command
/toh-ui Create a calendar page for room booking

Antigravity (agy CLI or Antigravity IDE)

# Start Antigravity CLI
agy

# Same commands
/toh-vibe Inventory management system

Codex — CLI and Codex desktop app (ChatGPT app)

codex

# Invoke a Toh workflow as a native Codex skill ($ + name), or browse with /skills
$toh-vibe Inventory management system

# Plain /toh-* text works too — AGENTS.md teaches Codex the full command set
/toh-vibe Inventory management system

The 8 Toh agents are also installed as native Codex agents in .codex/agents/*.toml (generated from .toh/agents/, ownership-tracked so your edits are never overwritten). They inherit the model of your session and carry only a reasoning-effort hint per role.

ZCode (Z.ai)

Open the project in the ZCode app, or run the bundled CLI:

zcode

# The 14 /toh-* commands are installed as real slash commands
/toh-vibe Inventory management system

Check what ZCode picked up at any time:

zcode skills list      # 37 project-scope skills
zcode commands list    # 14 /toh-* commands

---

📋 Available Commands

Command	Shortcut	Description
/toh	-	🧠 Smart Command - Type anything, AI picks agent
/toh-plan	/toh-p	📋 Plan - Writes .toh/plan.md, approve once, builds to the end
/toh-vibe	/toh-v	🎨 Create Project - Complete app in one command
/toh-ui	/toh-u	🖼️ Create UI - Pages, Components, Layouts
/toh-dev	/toh-d	⚙️ Add Logic - TypeScript, Zustand, Forms
/toh-design	/toh-ds	✨ Polish Design - Professional, not AI-looking
/toh-test	/toh-t	🧪 Test - Auto test & fix until pass
/toh-protect	/toh-pt	🔐 Security Audit - Full security check
/toh-connect	/toh-c	🔌 Connect Backend - Supabase, Auth, RLS
/toh-line	/toh-l	💚 LINE MINI App (convert)
/toh-mobile	/toh-m	📱 Mobile App - PWA / Capacitor
/toh-fix	/toh-f	🔧 Fix Bugs - Systematic debugging
/toh-ship	/toh-s	🚀 Deploy - Vercel, Production ready
/toh-help	/toh-h	❓ Help - Show all commands

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.

---

🏗️ Tech Stack (Fixed)

No decisions needed - optimized stack ready to go:

Category	Technology
Framework	Next.js 16 (App Router) + React 19
Styling	Tailwind CSS 4 + shadcn/ui
State	Zustand
Forms	React Hook Form + Zod
Backend	Supabase
Testing	Playwright
Language	TypeScript (strict)

---

🧠 Philosophy (AODD)

AI-Orchestration Driven Development:

1. Natural Language → Tasks - Just describe what you want
2. Orchestrator → Agents - System calls the right specialists
3. No Process Management - You just receive results
4. Test → Fix → Loop - Auto-fix until everything passes

User: "Create a coffee shop management system"

Orchestrator:
├── 📐 plan-orchestrator → Analyze & plan
├── 🎨 ui-builder → Create all UI
├── ⚙️ dev-builder → Add logic
├── ✨ design-reviewer → Polish design
├── 🧪 test-runner → Test & fix
├── 🔐 security-check → Audit code
└── ✅ Deliver working system!

🔁 Plan → Vibe Workflow

The plan is a file, never chat state:

• /toh-plan writes .toh/plan.md → you approve once ("Go") → the whole plan is built autonomously, verified checkpoint by checkpoint.
• /toh-vibe resumes any unfinished plan: it reads .toh/plan.md first and continues from the first unchecked task — in any session, any IDE.

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.

Unattended builds — kick off a full build headless (Claude Code):

claude -p "/toh-vibe coffee shop management system" --permission-mode acceptEdits

---

📖 Examples

Create E-commerce

/toh-vibe Online store with products, cart, and checkout

Create Dashboard

/toh-vibe Analytics dashboard with charts and date filters

Create SaaS

/toh-vibe Project management tool with teams and tasks

---

🎯 Target Users

• Solo Developers - Build SaaS single-handedly
• Solopreneurs - Create MVP to test market
• Startup Founders - Prototype for investors
• Freelancers - Deliver client work faster
• Students - Learn modern web development

---

📊 Framework Stats

• 🤖 8 Sub-Agents - Specialized for different tasks, installed natively on Claude Code, Cursor 2.4+, Antigravity, and Codex
• 🎯 14 Commands - From planning to deployment
• 📚 23 Skills - Comprehensive AI capabilities, shipped once to .agents/skills/ for every IDE that reads the open standard [NEW in 2.1]
• 🎨 Design Identity - Per-project DESIGN.md design identity + versioned AVOID-LIST
• 📦 15 Component Templates - Ready-to-use premium components
• 🌐 6 IDEs - Claude Code, Cursor, Antigravity (+ Antigravity CLI), Codex (CLI + desktop app), ZCode, Gemini CLI (legacy)

---

📚 Documentation & Guides

Guide	Where
🇹🇭 Thai documentation	docs/README-TH.md
Full version history	CHANGELOG.md
All commands + cheatsheet	run /toh-help in your IDE
Per-project guide (auto-generated)	CLAUDE.md / AGENTS.md / .cursor/rules/ / .agents/rules/ in your project after install
The plan artifact	.toh/plan.md — your app's live checklist (open it anytime to see progress)
Design contract	DESIGN.md at your project root — generated per project, edit it to steer the look

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

MIT License - see LICENSE for details.

👨‍💻 Author

Wasin Treesinthuros (Innovation Vantage)

• 🌐 Website: tohframework.dev
• GitHub: @wasintoh
• Email: dr.wasin@gmail.com

---

Made with ❤️ for Solo Developers everywhere.

"Type Once, Have it all!"