otter
First run

CLI

Otter CLI (@otter-engg/cli) is an interactive terminal product — splash, setup menus, then a session prompt. No Docker required. Data lives under ~/.otter/. Source: apps/cli.

Install

$ npm i -g @otter-engg/cli

For a global binary on PATH, prefer npm i -g @otter-engg/cli. pnpm, yarn, npm, and bun all install from the public npm registry — same package, no separate Bun publish.

Start

otter

After the welcome animation and login/model setup, you land on otter ›. Type a task, or use slash commands.

Slash commands

Understand

  • /scan — scan workspace
  • /intel — intelligence report
  • /health — health report
  • /review — code review
  • /docs — generate overview docs

Ask & plan

  • /chat <question>
  • /plan <request>
  • /memory [add <note>]

Build

  • /create <request> [--pr] [--yes] — plan → approve → implement → validate (edit-first tools; optional PR)
  • /pr — open PR for current local changes

Repos & session

  • /import owner/repo — clone from GitHub
  • /model [name] · /login · /logout
  • /update [--check] — upgrade @otter-engg/cli from npm
  • /clear · /help · /exit

Freeform prompts and /create follow the same contract as the Docker Coding UI: understand and plan first, then human approval before writes.

Release

Current CLI line: 0.2.0. See Changelog for Docker image + CLI upgrade commands.

Models

Default Ollama at http://127.0.0.1:11434/v1. Pick models during setup or with /model. More: Models.

Develop the CLI

git clone https://github.com/manasdutta04/otter.git
cd otter/apps/cli
npm install && npm run build
node dist/cli.js

See Contribute and https://otter.manasdutta.com.