Skip to content
Katachi

Quick Start

1. Start the Agent

Section titled “1. Start the Agent”
Terminal window
katachi start

On first run, you’ll be guided through authentication:

First-time setup detected!


Please visit: https://katachi.live/device
Enter code: ABCD-1234


Waiting for authorization...
✓ Authorized!
✓ Tunnel provisioned: agent-abc123.katachi.live
✓ Katachi agent started successfully


  PID:        12345
  Port:       7676
  Logs:       ~/.katachi/logs

2. Open the Web UI

Section titled “2. Open the Web UI”

Visit katachi.live and log in with the same account you just authorized.

You’ll see your agent appear as online in the dashboard. From here you can:

  • Start a new coding session
  • Select an AI provider and model
  • Open the file editor
  • Chat with your AI assistant

3. Start Coding

Section titled “3. Start Coding”

Create a new session, enter a Git repository URL, and select your AI provider. The Katachi agent will clone the repository into ~/.katachi/repos on your machine, giving the AI full access to the codebase and your development tools — all through the secure tunnel.

What’s Happening Behind the Scenes

Section titled “What’s Happening Behind the Scenes”
  1. The agent starts a local HTTP server on port 7676
  2. A Cloudflare tunnel connects your machine to the Katachi backend
  3. The web UI sends requests through the backend to your agent
  4. AI responses stream back in real-time via Server-Sent Events (SSE)

Next Steps

Section titled “Next Steps”