Self-hosted agentic AI in your terminal. Own your infrastructure. Control your data. The CLI surface of Dojo Genesis — same gateway, same ADA dispositions, same memory — without the browser.

Dojo Genesis is an open-source AI development platform built on a 100% Go-native architecture. The web shell organizes work into eight named surfaces — Garden, Practice, Trail, Partnership, Projects, Pipelines, Piloting, and Home — each one a different lens on your workspace. This CLI maps all eight to commands you can drive from a terminal, connect to CI scripts, or pipe into other tools.

The gateway does the heavy work: multi-provider model routing, semantic memory, MCP tool execution, durable agent sessions. The CLI connects to it, streams responses, and keeps your hands on the keyboard.

# Install via Homebrew (recommended)
brew install DojoGenesis/tap/dojo
# Point at your gateway
echo '{"gateway":{"url":"http://localhost:7340"}}' > ~/.dojo/settings.json
# Run
dojo

git clone https://github.com/DojoGenesis/cli
cd cli
make install

Requires Go 1.24+. The binary is installed to $GOPATH/bin/dojo.

curl -sSL https://raw.githubusercontent.com/DojoGenesis/cli/main/scripts/install.sh | bash

Settings are loaded from ~/.dojo/settings.json. A missing file is not an error — all fields have defaults.

{
 "gateway": {
 "url": "http://localhost:7340",
 "timeout": "60s",
 "token": ""
 },
 "plugins": {
 "path": "~/.dojo/plugins"
 },
 "defaults": {
 "provider": "",
 "disposition": "balanced",
 "model": ""
 }
}

Environment variable overrides:

• Go 1.24+ (for building from source)
• AgenticGateway running at localhost:7340 (default)

One-shot mode is useful for scripting:

dojo --one-shot "what models are available?" --gateway http://localhost:7340
# JSON output for pipelines
dojo --one-shot "summarize the last run" --json | jq '.text'

Resume most recent session:

dojo --resume

Shell completions:

dojo --completion zsh >> ~/.zshrc
dojo --completion bash >> ~/.bashrc
dojo --completion fish > ~/.config/fish/completions/dojo.fish

Type a message without / to chat with the gateway. Use slash commands for structured operations.

Session IDs follow the format dojo-cli-YYYYMMDD-HHmmss when created via /session new.

Project phases: initialized, scouting, specifying, decomposing, commissioning, implementing, retrospective, archived.

Track statuses: pending, in-progress, completed, blocked.

cli/
├── cmd/ # Cobra command tree
├── internal/
│ ├── repl/ # Interactive REPL and TUI panels
│ ├── client/ # Gateway HTTP + SSE client
│ ├── plugin/ # Plugin loader and hook runner
│ ├── skill/ # Skill and CAS commands
│ └── spirit/ # Belt, XP, achievements, koans
├── desktop/ # Desktop app (Wails v2 + Svelte 5)
└── scripts/ # Install and release scripts

A native desktop variant lives at cli/desktop/ — built with Wails v2 (Go backend) and Svelte 5 (frontend). It connects to the same gateway and exposes the same chat and piloting surfaces in a windowed app. go build is clean; smoke testing against the gateway is in progress.

Dojo Genesis organizes work into eight named surfaces. The CLI maps each one to a command or interaction mode, so the mental model carries over from the web shell to the terminal.

ADA (Adaptive Disposition Architecture) controls how the gateway approaches a task. Every agent dispatch and direct chat session can carry a disposition. Four built-in presets are provided:

Set a session default in ~/.dojo/settings.json under defaults.disposition, or pass it per-session:

dojo --disposition deliberate

Per-dispatch:

/agent dispatch focused summarize the last 5 decisions

Create and save custom presets with /disposition create:

/disposition create sprint fast shallow assertive high

Plugins extend the CLI with hook rules and skills. Place plugin directories under ~/.dojo/plugins/ (or the path configured in plugins.path), or use /plugin install to clone from a git URL.

Each plugin directory must contain a plugin.json manifest:

{
 "name": "my-plugin",
 "version": "1.0.0",
 "hooks": [
 {
 "event": "session.start",
 "type": "command",
 "command": "/usr/local/bin/my-hook"
 }
 ]
}

Plugin management commands:

/plugin ls # list installed plugins
/plugin install https://github.com/... # clone a plugin from git
/plugin rm my-plugin # remove an installed plugin
/hooks ls # list all hook rules
/hooks fire session.start # manually fire a hook event

Plugins are rescanned live after install and remove operations — no restart needed.

Dojo Spirit is the engagement system built into the CLI. It tracks XP, belt ranks, daily streaks, achievements, and unlockable koans — all stored locally in ~/.dojo/state.json.

Belt ladder:

XP is earned through guided tutorials (/guide), daily practice sessions, and regular CLI use. Belt promotions display inline in the REPL. /card shows your current rank, XP progress bar, session count, streak, and unlocked achievements. /sensei delivers a koan matched to your belt rank.

Sessions scope conversation history on the gateway. Each dojo invocation generates a session ID automatically. You can rotate or resume sessions mid-session.

/session # show current session ID
/session new # rotate to a fresh session
/session dojo-cli-20260409 # resume a specific session

Use --resume at startup to continue the most recent session automatically.

The CLI renders in truecolor using the Dojo Genesis sunset palette: warm-amber (#e8b04a) for headers, golden-orange (#f4a261) for command names, cloud-gray (#94a3b8) for descriptions, soft-sage (#7fb88c) for success states, and info-steel (#457b9d) for tool and trace annotations. The sunset gradient (#ffd166 → #f4a261 → #e76f51) anchors the palette — the same gradient that runs across the web shell's dock brand mark and hover indicators.

Interactive panels (/home, /pilot, /bloom, /warroom) use Bubble Tea with alternate-screen mode. Plain-text fallbacks (/home plain, /pilot plain) are available for non-interactive or --no-color contexts. Truecolor rendering is provided by lipgloss and gookit/color; both degrade gracefully on terminals that report limited color support.

make test # run tests
make vet # go vet
make build # build binary to ./bin/dojo
make all # vet + test + build

Module path: github.com/DojoGenesis/cli

Key dependencies: charmbracelet/bubbletea, charmbracelet/lipgloss, fatih/color, gookit/color, chzyer/readline.

MIT