dosu-cli

Connect Dosu to your AI coding tools. dosu authenticates you, picks a Dosu deployment, and wires the Dosu MCP server into Claude Code, Cursor, Codex, and more — plus commands to drive the Dosu platform from your terminal.

Quick Start

curl -fsSL https://cli.dosu.dev/install | sh

The interactive wizard authenticates you via browser OAuth, lets you pick a Dosu deployment (or OSS / public-library mode), mints an API key, detects which AI tools you have installed, and writes the Dosu MCP server entry into each one's config. Restart your AI tool and Dosu is available.

Run dosu with no arguments any time to open the interactive menu.

Installation

curl / install (macOS / Linux) (Recommended)

Downloads and installs the latest stable release binary.

curl -fsSL https://cli.dosu.dev/install | sh

To install a specific release tag:

DOSU_INSTALL_VERSION=v0.2.0-rc1 curl -fsSL https://cli.dosu.dev/install | sh

npx / npm

Requires Node.js 22+.

npx @dosu/cli setup

Or install globally:

npm install -g @dosu/cli
dosu setup

Homebrew

brew install dosu-ai/dosu/dosu

Or tap first:

brew tap dosu-ai/dosu
brew install dosu

Manual Download

Download the appropriate archive from the Releases page.

macOS Gatekeeper Warning

When downloading directly from GitHub releases on macOS, you may see:

"Apple could not verify dosu is free of malware that may harm your Mac or compromise your privacy."

This happens because the binary is not signed with an Apple Developer certificate. To bypass this:

# After extracting the archive, remove the quarantine attribute:
xattr -d com.apple.quarantine ./dosu

Or right-click the binary, select "Open", and click "Open" in the dialog.

Note: Installing via Homebrew avoids this issue automatically.

Usage

Core commands

| Command | Description | |---|---| | dosu | Launch the interactive TUI menu | | dosu setup | Run the setup wizard (auth → deployment → detect tools → configure) | | dosu login | Authenticate with Dosu via browser OAuth | | dosu logout | Clear saved credentials | | dosu status | Show current authentication and MCP status | | dosu mcp list | List supported AI tools | | dosu mcp add <tool> | Add the Dosu MCP server to a specific tool | | dosu logs | View or manage debug logs (--tail, --clear) |

dosu mcp add takes -g, --global to install for all projects instead of project-local, and --show-secret to print the full manual config.

Platform commands

Once authenticated against a deployment, you can drive the Dosu platform without leaving the terminal:

| Command | Description | |---|---| | dosu ask | Ask a question and get an AI-generated answer | | dosu knowledge | Search and browse your knowledge base | | dosu docs | Manage documents (list, create, update, import, publish, AI-generate) | | dosu suggest | Review and manage AI document suggestions | | dosu threads | List and manage conversation threads | | dosu review | Document review workflow | | dosu sources | Manage connected data sources (list, sync, update) | | dosu integrations | List and inspect platform integrations (Slack, GitHub, …) | | dosu tags | List knowledge base tags and tagged pages | | dosu members | Manage team members and access requests | | dosu org | Show organization information | | dosu deployments | List / show / switch deployments | | dosu analytics | View usage statistics | | dosu insights | Open a visual report of your Dosu space activity | | dosu skill | Install / update / remove the Dosu agent skill | | dosu hooks | Install / remove / diagnose Dosu coding-agent hooks |

Run dosu <command> --help for subcommands and flags.

Supported AI tools

dosu mcp add <id> and the setup wizard support:

| ID | Tool | |---|---| | claude | Claude Code | | claude-desktop | Claude Desktop | | cursor | Cursor | | vscode | VS Code | | codex | Codex CLI | | gemini | Gemini CLI | | windsurf | Windsurf | | zed | Zed | | cline | Cline | | cline-cli | Cline CLI | | copilot | GitHub Copilot CLI | | opencode | OpenCode | | antigravity | Antigravity | | mcporter | MCPorter | | factory | Factory | | manual | Manual Configuration (prints config to paste yourself) |

Non-interactive / agent setup

For coding agents and CI, setup has a non-interactive mode:

dosu setup --agent --tool claude

Combine with dosu login --request / --check <ticket> for human-in-the-loop authentication, and --mode oss|cloud to skip the mode prompt.

Configuration

Credentials and the selected deployment live in ~/.config/dosu-cli/config.json. Set DOSU_DEV=true to isolate config under ~/.config/dosu-cli-dev/.

To repoint a published build at a different backend without rebuilding, set any of these runtime overrides:

• DOSU_WEB_APP_URL_OVERRIDE
• DOSU_BACKEND_URL_OVERRIDE
• SUPABASE_URL_OVERRIDE
• SUPABASE_ANON_KEY_OVERRIDE

Development

bun install        # install dependencies
bun run dev        # run the CLI from source
bun run test       # run tests (vitest)
bun run check      # lint + format check (Biome)
bun run typecheck  # tsc --noEmit

See AGENTS.md for architecture and contributor notes.

Releasing (for maintainers)

Releases are fully automated with semantic-release — there are no manual version tags. Every push to a release branch is analyzed for Conventional Commit messages, which determine the version bump.

| Branch | npm dist-tag | Version shape | |---|---|---| | main | latest | 0.20.1 | | alpha | alpha | 0.20.1-alpha.1 |

On a qualifying push, the CI pipeline bumps the version, builds binaries for all platforms, creates a GitHub release with the archives, publishes to npm, and (for stable releases only) updates the Homebrew formula.

Commit messages that don't follow Conventional Commits are invisible to semantic-release and won't trigger a release. See AGENTS.md for the full type → release-impact table and the alpha channel workflow.

License

MIT — see the license field in package.json.