Environment Variables

Agent Configuration

Variable	Default	Description
KATACHI_PORT	7676	HTTP server port
KATACHI_HOME	~/.katachi	Agent data directory
KATACHI_DEBUG	—	Set to true for verbose debug logging
KATACHI_API_URL	https://api.katachi.live	Backend API URL (for development)

Install-Time

Variable	Default	Description
CLOUDFLARED_SKIP	—	Set to 1 to skip cloudflared binary download during install

AI Provider Keys

These override OAuth tokens when set:

Variable	Provider
ANTHROPIC_API_KEY	Claude (Anthropic)
GEMINI_API_KEY	Gemini (Google)
OPENAI_API_KEY	GPT / Codex (OpenAI)

Priority Order

When multiple configuration sources exist, they’re resolved in this order (highest priority first):

1. CLI flags — katachi start --port 3001
2. Environment variables — KATACHI_PORT=3001
3. Defaults — Built-in default values