Install

Requirements

• macOS or Linux.
• Claude Code or Codex.
• Python 3.9 or newer. That’s all: Dobi uses only Python’s standard library, so there’s no setup step and nothing to install.

Check Python with:

python3 --version

If a Mac says python3 isn’t there, install Apple’s Command Line Tools, which include it:

xcode-select --install

Claude Code

In a Claude Code session:

/plugin marketplace add https://github.com/run-llama/dobi.git
/plugin install dobi@dobi

Then start a new session. The full https:// address works without a GitHub SSH key.

Codex

In a terminal:

codex plugin marketplace add run-llama/dobi
codex plugin add dobi@dobi

Then start a new session. The Codex IDE extension doesn’t support plugins yet.

From the app’s download

Signed in to the app, Settings has Download the plugin. Unzip it, then from the folder that holds dobi/:

cd dobi
claude plugin marketplace add .
claude plugin install dobi@dobi

Or for Codex, codex plugin marketplace add . then codex plugin add dobi@dobi.

Updating from 0.5.0

Plugin 0.5.0 kept its local data encrypted. 0.6.0 can’t read that data, so it stops with a message and changes nothing. Keep using 0.5.0 with that folder, or set DOBI_HOME to a new folder to start fresh. See Troubleshooting.

Next: connect your account.