██╗ ██╗██╗ ██╗ ██████╗ ████████╗███████╗███████╗ ██║ ██╔╝╚██╗ ██╔╝██╔═══██╗╚══██╔══╝██╔════╝██╔════╝ █████╔╝ ╚████╔╝ ██║ ██║ ██║ █████╗ █████╗ ██╔═██╗ ╚██╔╝ ██║ ██║ ██║ ██╔══╝ ██╔══╝ ██║ ██╗ ██║ ╚██████╔╝ ██║ ███████╗███████╗ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚══════╝╚══════╝
Autonomous Development Agent
Describe what you want. Kyotee builds it.
A Go CLI that discovers requirements, plans implementation,
builds in chunks, and verifies everything actually works.
go install github.com/stukennedy/kyotee@latest
v0.3.0 Features
What makes Kyotee different
Chunked Implementation
Fresh context window per chunk. Large projects stay sharp — no quality degradation as complexity grows.
Goal-Backward Verification
Checks artifacts actually exist. Detects stubs and placeholder code. Verifies wiring between components.
Structured Checkpoints
Agent pauses for human decisions, visual verification, or manual actions. Resume anytime with full context.
Battle-Tested Prompts
Deviation rules auto-fix bugs. Commit protocols enforce clean history. Security defaults baked in.
Tooey TUI
Beautiful terminal interface with phase progress bars, streaming output, and interactive checkpoint prompts.
Tech Stack Skills
Built-in patterns for Hono, Go+Gin, Next.js, and FastAPI. Kyotee auto-selects during discovery.
How It Works
Discovery → Implementation → Checkpoints
1. Discovery
Launch kyotee and it opens an interactive TUI. Asks targeted questions, understands your codebase, and builds a detailed spec before writing a single line.
$ kyotee run -t "build a REST API with auth and todos"
$ kyotee # interactive mode — TUI asks questions
$ kyotee jobs # list all jobs
$ kyotee resume <id> # pick up where you left off2. Chunked Implementation
Kyotee splits work into chunks, each with a fresh context window. No quality degradation on large projects. Deviation rules auto-fix bugs, stub detection catches placeholders.
Context
Analyzes codebase, loads relevant files, matches tech stack patterns.
Plan
Creates step-by-step implementation plan from the approved spec.
Implement
Builds in chunks with fresh context. Deviation rules catch and fix issues inline.
Verify
Goal-backward verification: checks artifacts exist, detects stubs, verifies wiring.
3. Checkpoints & Resume
Kyotee pauses at structured checkpoints — when it needs a human decision, visual verification, or manual action. Resume anytime with full job persistence.
human-verify
"Check the UI looks right before I continue"
decision
"Should I use JWT or session auth?"
human-action
"Set up the database, then tell me to continue"
$ kyotee jobs
ID STATUS TASK
a3f2c1 paused REST API with auth
b7d4e9 completed CLI todo app
$ kyotee resume a3f2c1
Resuming from checkpoint: human-verify
"Check the auth flow works, then press Enter"Getting Started
Install and run in 60 seconds
Install Kyotee
go install github.com/stukennedy/kyotee@latest
Requires Go 1.24+
Ensure Claude Code is ready
claude --version
Claude Code CLI must be installed and authenticated
Run Kyotee
kyotee
Answer discovery questions, approve the spec, and watch it build.
Requirements
- Go 1.24+
- Claude Code CLI installed and authenticated
Or use as a Claude Code Skill
git clone https://github.com/stukennedy/kyotee.git
cp -r kyotee/.claude/skills/kyotee ~/.claude/skills/Then use /kyotee inside Claude Code. Same engine, different interface.
Built-in Patterns
Kyotee auto-selects the right pattern during discovery
Hono + Datastar
Cloudflare Workers, hypermedia, SSE streaming
Go + Gin
REST APIs with clean architecture
Next.js + Tailwind
React full-stack with App Router
Python + FastAPI
Async APIs with Pydantic
Create custom patterns with markdown files. See docs →
Interactive Demo
See Kyotee's phases in action