Configuration

settings.json

Shared settings live in .clew/settings.json (checked into the repo) and private settings live in .clew/settings.local.json (gitignored).

{
  "permission": "default",
  "provider": "openai",
  "model": "gpt-5.5",
  "theme": "dark",
  "autoUpdate": true
}

Environment Variables

Set provider API keys as environment variables:

export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export GOOGLE_API_KEY=...
export DEEPSEEK_API_KEY=sk-...
export GROQ_API_KEY=gsk_...
export MISTRAL_API_KEY=...
export OPENROUTER_API_KEY=...
export OLLAMA_HOST=http://localhost:11434

The app also reads from .env files in the project root.

CLI Flags

Flag	Description
-p, --prompt	One-shot mode: run a prompt and exit
--resume <id>	Resume a previous session (use last for most recent)
--version	Print version and exit

Permission Mode

Set the permission mode in settings or switch at runtime:

❯ /permissions plan    # full-access planning mode
❯ /permissions auto    # auto-approve safe tools

See Permission Model for all modes.

MCP Configuration

MCP servers are configured in .mcp.json at the project root:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

See MCP docs for details.