CLI

The CLI is a thin client of the same Otter API the Docker web UI uses. It does not embed Postgres — start Docker first, then log in.

Prerequisites

1. Run the platform stack (Self-host) so http://127.0.0.1:8000 is up.
2. Build or install the CLI from apps/cli.

Login

otter login
# Browser → Otter GitHub App (Cloudflare broker) → ~/.otter/config.json

Same Connect flow as the web UI. See GitHub.

Useful commands

• otter repos list / otter repos import <url>
• otter chat / otter plan / otter review
• otter logout

MCP

After otter login, point your MCP client at python apps/mcp/server.py with OTTER_API_URL=http://127.0.0.1:8000. The server reads ~/.otter/config.json when OTTER_SESSION is unset.

Source

Repository