Hybrid User: Web App + Local Runtime

Chat with the AI from your browser while it executes commands on your local machine. This is useful when you want browser-based access, need multi-agent workflows, or want to interact from a different device.

How It Works

  +-- Your Terminal --------+     +-- Browser -----------------+
  |                          |     |                            |
  |  kiwi-runtime connect    |     |  kiwicode.ai               |
  |  (WebSocket to backend)  |<===>|  /autocode/new             |
  |                          |     |                            |
  |  AI executes commands    |     |  You type messages here    |
  |  on your machine         |     |                            |
  +--------------------------+     +----------------------------+

1. You start kiwi-runtime in your terminal — it connects to the backend and waits
2. You open the web app in your browser and start a new conversation
3. You ask the AI to connect to your CLI runtime
4. The AI binds to your runtime and can now execute commands on your machine

Step by Step

1. Install

Install kiwi-ai via pip, pipx, or uv:

pip install kiwi-ai

pipx install kiwi-ai

uv pip install kiwi-ai

2. Start the Runtime

Open your terminal and run:

kiwi-runtime connect --scope full

You'll see output like:

> Connected as user@example.com
> Agent ID: abc123-def456

  Ready | Mode: unrestricted | Ctrl+C to disconnect
  ──────────────────────────────────────────────────

The runtime is now waiting for the AI to connect. Keep this terminal open.

3. Open the Web App

Go to https://kiwicode.ai/autocode/new in your browser.

4. Start Chatting

In the chat, ask the AI to connect to your runtime:

Connect to my CLI runtime and list the files in my current directory

The AI will detect your running runtime, bind to it, and start executing commands on your machine.

5. Ask the AI to Do Anything

Once connected, you can ask the AI to:

• Read and analyze your codebase
• Write or modify files
• Run tests and fix failures
• Execute shell commands
• Search through your project
• Trigger multi-agent workflows

Stopping

Press Ctrl+C in the terminal where kiwi-runtime is running to disconnect.

What You Get

• Browser-based chat interface
• AI executes on your local machine
• Multi-agent parallel workflows
• File attachments via drag & drop
• Access from any device with a browser

Next Steps