Skip to main content

​
Usage

klaw chat [flags]

​
Description

Start an interactive chat session with an AI agent. This is the primary way to interact with klaw for development and exploration.

​
Flags

FlagShortDescriptionDefault
--model-mModel to useAuto-detected
--provider-pProvider: anthropic, openrouter, eachlabsAuto-detected
--agent-aAgent name to usedefault
--tuiUse TUI mode (Bubble Tea)false
--simpleSimple terminal mode (no styling)false

​
Examples

​
Basic Chat

klaw chat

​
Specify Model

klaw chat --model claude-sonnet-4-20250514
klaw chat --model gpt-4o

​
Use TUI Mode

klaw chat --tui

​
Chat with Specific Agent

klaw chat --agent coder
klaw chat --agent researcher

​
Specify Provider

klaw chat --provider anthropic
klaw chat --provider openrouter
klaw chat --provider eachlabs

​
Provider Auto-Detection

klaw automatically detects the provider based on available environment variables:
  1. OPENROUTER_API_KEY → OpenRouter
  2. EACHLABS_API_KEY → each::labs
  3. ANTHROPIC_API_KEY → Anthropic
Override with --provider flag.

​
Model Auto-Detection

If no model is specified, klaw uses defaults based on provider:
ProviderDefault Model
Anthropicclaude-sonnet-4-20250514
OpenRouteranthropic/claude-sonnet-4
each::labsanthropic/claude-sonnet-4-5

​
Chat Modes

​
Terminal Mode (Default)

Styled terminal output with colors and formatting: 
klaw v1.0.0 - The Kubernetes for AI Agents
Using model: claude-sonnet-4-20250514

> Hello!

Hello! How can I help you today?

> _

​
TUI Mode

Rich terminal UI with Bubble Tea: 
klaw chat --tui
Features:
  • Syntax highlighting
  • Scrollable history
  • Progress indicators
  • Keyboard shortcuts

​
Simple Mode

Basic terminal without styling (for compatibility): 
klaw chat --simple

​
Tool Execution

During chat, agents can use tools: 
> List the files in this directory

[Tool: glob] Finding files...
├── cmd/
├── internal/
├── go.mod
└── README.md

This directory contains a Go project with...

​
Keyboard Shortcuts

KeyAction
EnterSend message
Shift+EnterNew line
Ctrl+CExit
Ctrl+LClear screen
Up/DownHistory navigation

​
Environment Variables

ANTHROPIC_API_KEY    # Required for Anthropic
OPENROUTER_API_KEY   # Required for OpenRouter
EACHLABS_API_KEY     # Required for each::labs
KLAW_MODEL           # Override default model

​
See Also