Tonkotsu is a desktop application that positions developers as tech leads managing teams of AI coding agents. By combining structured planning, autonomous code execution, and comprehensive review workflows, Tonkotsu transforms how developers approach complex software projects with AI assistance.

Tonkotsu addresses the challenge of coordinating multiple coding tasks simultaneously while maintaining quality and control. It enables developers to break down technical work into manageable tasks, delegate them to AI agents that work in parallel, and maintain oversight through a streamlined review process. Software engineers and development teams use Tonkotsu to accelerate project timelines, handle complex multi-repository codebases, and scale their productivity without sacrificing code quality or architectural decisions.

Key Features of Tonkotsu

  • Plan-Code-Verify Workflow: Structured three-phase approach enabling developers to plan projects, delegate tasks, and review changes systematically.
  • Multi-Repository Planning: Coordinate coding tasks across multiple repositories simultaneously while maintaining architectural consistency throughout your codebase.
  • Symbol Lookup Integration: Quickly reference and navigate code symbols across your projects to make informed technical decisions during planning.
  • Task Dependency Management: Specify relationships between coding tasks to ensure proper execution order and prevent conflicts in parallel workflows.
  • Automatic Verification: Built-in verification systems check code changes before commits to catch errors and maintain quality standards automatically.
  • Local Repository Execution: All code execution happens in isolated repository clones on your development machine for enhanced security.
  • Parallel Task Delegation: Delegate dozens of coding tasks simultaneously while AI agents work autonomously without requiring constant supervision.
  • Diff Review Interface: Review all code changes with comprehensive diff views before approving commits to your repositories.
  • Instant Feedback Loop: Provide feedback on code changes and receive immediate turnaround from agents to iterate quickly.
  • Natural Language Planning: Write project requirements and technical work in bullet points without complex configuration or setup.
  • SOC 2 Type I Certified: Enterprise-grade security compliance with successful SOC 2 Type I audit completion for data protection.
  • JavaScript and TypeScript Optimization: Specifically designed and optimized for JavaScript and TypeScript development workflows and ecosystems.

How to Use Tonkotsu

  • Download the Tonkotsu desktop application for macOS or Windows from the official website and complete installation.
  • Open Tonkotsu and create a new project document where you will outline your technical work.
  • Draft your project plan by writing out requirements and tasks in natural language bullet points.
  • Review the AI-generated plan and make any necessary adjustments to align with your technical decisions.
  • Delegate tasks to Tonkotsu agents which will execute code changes autonomously on your local machine.
  • Monitor agent progress as they work in parallel on multiple tasks across your repositories.
  • Review diff outputs for each completed task to understand the changes before approving them.
  • Provide feedback on code changes and request modifications if needed for quality or alignment.
  • Approve verified changes to commit them to your repositories after confirming quality standards.
  • Iterate on additional tasks or refinements using the same structured workflow for consistency.

Key Use Cases for Tonkotsu

  • Multi-Repository Refactoring: Coordinate large-scale refactoring efforts across multiple repositories while maintaining consistency and preventing breaking changes.
  • Feature Development Acceleration: Speed up feature development by delegating implementation tasks to AI agents while retaining architectural control and oversight.
  • Technical Debt Reduction: Systematically address accumulated technical debt by breaking down cleanup tasks and delegating them for parallel execution.
  • Codebase Modernization: Update frameworks, libraries, and patterns across entire codebases with coordinated changes managed through dependency tracking.
  • API Development: Design and implement APIs by planning endpoints, delegating implementation, and verifying contracts before deployment.
  • Bug Fix Management: Organize bug fixes into dependencies and parallel tasks to resolve issues faster while maintaining test coverage.
  • Documentation Generation: Create comprehensive code documentation by delegating documentation tasks for functions, modules, and APIs systematically.
  • Test Coverage Expansion: Increase test coverage by planning test scenarios and delegating test implementation across your codebase components.

Pros and Cons

Pros

  • Structured workflow keeps developers in control
  • Parallel task execution significantly accelerates development
  • Local code execution enhances security
  • Multi-repository support handles complex codebases
  • Free during early access program

Cons

  • Currently limited to macOS and Windows platforms with no Linux native support available yet.
  • Optimized primarily for JavaScript and TypeScript which may limit effectiveness for other programming languages.
  • Being in early access means potential bugs or incomplete features may affect development workflows.

Frequently Asked Questions

What is Tonkotsu?

Tonkotsu is a desktop application that enables developers to manage teams of AI coding agents through structured workflows.

Is Tonkotsu Free to Use?

Yes, Tonkotsu is currently free to use during its early access program for all users.

What operating systems does Tonkotsu support?

Tonkotsu is available for macOS and Windows with WSL support for Windows users currently.

Does Tonkotsu work with multiple repositories?

Yes, Tonkotsu supports multi-repository planning and coordination for complex project architectures and codebases.

Where does Tonkotsu execute code?

Tonkotsu executes all code in isolated repository clones on your local development machine for security.

What programming languages does Tonkotsu support?

Tonkotsu is optimized for JavaScript and TypeScript development with best performance for these languages.

Can I review code before it is committed?

Yes, all code changes require review and approval before commits are made to repositories.

Is Tonkotsu secure for enterprise use?

Yes, Tonkotsu has completed SOC 2 Type I audit successfully and maintains enterprise security standards.