🎯 Toh Framework

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

🌐 Official Website: tohframework.dev

📖 🇹🇭 Thai Documentation

🤖 Supported IDEs

| IDE | Status | Notes | |-----|--------|-------| | 🧠 Claude Code | ✅ Full Support | Native Sub-Agents, Slash commands | | 📝 Cursor | ✅ Full Support | @ file references | | 🌌 Google Antigravity | ✅ Full Support | Gemini integration | | 💎 Gemini CLI | ✅ Full Support | Context files auto-loaded | | 🤖 Codex CLI | ✅ Supported | OpenAI agents |

💡 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

🆕 What's New in v1.8.1

🌐 Google Antigravity Workflows

Full support for Google Antigravity IDE! Commands now appear when pressing /:

• 13 workflow files created in .agent/workflows/
• Commands use dash syntax (/toh-vibe) in Antigravity
• Separate from Gemini CLI which uses colon syntax (/toh:vibe)

🧠 7-File Memory System

Enhanced memory tracking with 2 new files:

| Memory File | Purpose | |-------------|---------| | active.md | Current task | | summary.md | Project overview | | decisions.md | Key decisions | | changelog.md | NEW! Session changes | | agents-log.md | NEW! Agent activity log | | architecture.md | Project structure | | components.md | Component registry |

📢 Agent Announcements

All agents now announce themselves when working:

[🎨 UI Builder] Starting: Create Dashboard Page
[🎨 UI Builder] ✅ Complete: Dashboard with 3 components

⚡ Parallel Execution

Agents can now work simultaneously when there are no dependencies:

Phase 1: [🎨 UI] + [⚙️ Dev]    ← PARALLEL
Phase 2: [🔌 Backend]          ← SEQUENTIAL
Phase 3: [✨ Design] + [🧪 Test] ← PARALLEL

🎯 Agent Selection Reasoning

Before executing, see why AI chose specific agents:

🔍 Analysis:
| Need | Agent | Confidence |
|------|-------|------------|
| Create pages | 🎨 UI | 95% |
| Add logic | ⚙️ Dev | 90% |
| Connect DB | 🔌 Connect | 95% |

🤖 7 Sub-Agents v2.1

| Agent | Specialty | |-------|-----------| | 🎨 ui-builder | Pages, Components, Layouts | | ⚙️ dev-builder | Logic, State, API | | 🔌 backend-connector | Supabase, Auth, RLS | | ✨ design-reviewer | Polish, Animation | | 🧪 test-runner | Auto test & fix | | 🧠 plan-orchestrator | Analyze, Plan | | 📱 platform-adapter | LINE, Mobile, Desktop |

📜 Previous Versions

See CHANGELOG.md for complete version history.

Recent highlights:

| Version | Date | Key Feature | |---------|------|-------------| | v1.8.0 | 2026-01-11 | 7-File Memory System, Agent Announcements | | v1.7.1 | 2026-01-11 | Gemini CLI Native Commands (TOML) | | 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 | | v1.4.0 | 2025-12-04 | /toh Smart Command, Premium Experience |

✨ Features

| Feature | Description | |---------|-------------| | /toh Smart Command | Type anything, AI picks the right agent | | Sub-Agents | 7 specialized agents for different tasks | | Multi-Agent Orchestration | Complex workflows with full visibility | | Premium Experience | 5+ pages with animations in one prompt | | Design Mastery | 13 business profiles for smart design | | Auto Memory | Context persists across sessions and IDEs | | Auto Testing | Test & fix loop until all pass |

📦 Installation

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

# Quick install (Claude Code + Cursor, 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 gemini
npx toh-framework install --ide codex

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

🔄 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!

🚀 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

# Call Toh agent
@toh Create a meeting room booking system

# Or use specific command
@toh:ui Create a calendar page for room booking

Gemini CLI / Antigravity

# Start Gemini CLI
gemini

# Use commands
/toh-vibe Inventory management system

📋 Available Commands

| Command | Shortcut | Description | |---------|----------|-------------| | /toh | - | 🧠 Smart Command - Type anything, AI picks agent | | /toh-plan | /toh-p | 📋 Plan - Analyze, plan, orchestrate | | /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 [NEW] | | /toh-connect | /toh-c | 🔌 Connect Backend - Supabase, Auth, RLS | | /toh-line | /toh-l | 💚 LINE Mini App - LIFF integration | | /toh-mobile | /toh-m | 📱 Mobile App - Expo / React Native | | /toh-fix | /toh-f | 🔧 Fix Bugs - Systematic debugging | | /toh-ship | /toh-s | 🚀 Deploy - Vercel, Production ready | | /toh-help | /toh-h | ❓ Help - Show all commands |

🏗️ Tech Stack (Fixed)

No decisions needed - optimized stack ready to go:

| Category | Technology | |----------|------------| | Framework | Next.js 14 (App Router) | | Styling | Tailwind CSS + 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 [NEW]
└── ✅ Deliver working system!

📖 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

• 🤖 7 Sub-Agents - Specialized for different tasks
• 🎯 15 Commands - From planning to deployment [NEW: /toh-protect]
• 📚 24 Skills - Comprehensive AI capabilities [NEW: Security Engineer]
• 🎨 13 Design Profiles - Business-appropriate design
• 📦 15 Component Templates - Ready-to-use premium components
• 🌐 5 IDEs - Claude Code, Cursor, Antigravity, Gemini, Codex

🤝 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: [email protected]