Install

npm install -g @eldlabs/kodo-cli
# or
bun add -g @eldlabs/kodo-cli

Then run it from inside any project directory:

kodo

What it does

Kodo is a full-screen terminal UI for AI-assisted coding. It connects to the Kodo cloud API and gives you a streaming AI chat interface that can read and write files, run shell commands, and browse your codebase — all from within your terminal.

Features

• Terminal UI — Full-screen interactive interface powered by OpenTUI and React
• Plan mode — Read-only analysis: the AI can read files, list directories, glob, and grep without making any changes
• Build mode — Full tool access: read, write, edit files, and run shell commands inside the current project
• Streaming responses — Token-by-token streaming with persistent session history
• Multi-model — Switch between Claude (Opus, Sonnet, Haiku), GPT-4o, and Gemini models mid-session
• Session history — Resume past conversations from any project
• Credit-based billing — Buy credits, track usage, and manage your subscription from inside the app

Getting started

1. Sign in

Launch Kodo and run the /login command. It will open your browser to authenticate — no password to type.

/login

2. Pick a mode

| Mode | What the AI can do | |------|-------------------| | Plan | Read files, search, analyse — no writes | | Build | Read + write files, edit, run shell commands |

Switch modes with /agents.

3. Pick a model

/models

Supported models:

| Model | Provider | |-------|----------| | gemini-2.5-pro | Google | | gemini-2.5-flash | Google | | gemini-2.0-flash | Google | | claude-opus-4-6 | Anthropic | | claude-sonnet-4-6 | Anthropic | | claude-haiku-4-5 | Anthropic | | gpt-4o | OpenAI | | gpt-4o-mini | OpenAI |

4. Start coding

Type your request and press Enter. Kodo streams the response and executes any tool calls (file reads, writes, shell commands) locally.

Commands

Type / at the input bar to open the command menu, or use any of these directly:

| Command | Description | |---------|-------------| | /new | Start a new conversation | | /agents | Switch between Plan and Build mode | | /models | Change the AI model | | /sessions | Browse and resume past sessions | | /theme | Change the color theme | | /login | Sign in with your browser | | /logout | Sign out | | /upgrade | Buy more credits | | /usage | Open the billing portal | | /exit | Quit |

Keyboard shortcuts

| Key | Action | |-----|--------| | Enter | Send message | | / | Open command menu | | Esc | Close dialog / cancel | | ↑ ↓ | Scroll through messages |

Credits

Kodo uses a credit system. Each AI response costs credits based on the model and token usage. Buy credits with /upgrade, track usage with /usage.

Configuration

Kodo stores its config at ~/.kodo/config.json. This file is created automatically on first sign-in.

Requirements

• Node.js ≥ 18 or Bun ≥ 1.0
• macOS or Linux

Links

• GitHub
• npm