dosu-cli

⚠️ Pre-Release:

The Dosu CLI is pre-release alpha software and is not fully supported currently. Please check back soon. Join our Discord so you'll be the first to know when it's launched!

Installation

npx / npm (Recommended)

Requires Node.js 18+.

npx @dosu/cli setup

Or install globally:

npm install -g @dosu/cli
dosu setup

curl / install (macOS / Linux)

Downloads and installs the latest stable release binary.

curl -fsSL https://raw.githubusercontent.com/dosu-ai/dosu-cli/main/install.sh | sh

To install a specific release tag:

DOSU_INSTALL_VERSION=v0.2.0-rc1 curl -fsSL https://raw.githubusercontent.com/dosu-ai/dosu-cli/main/install.sh | sh

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.

Releasing (for maintainers)

Releases are automated via bun build --compile and GitHub Actions.

Creating a Release

1. Ensure all changes are committed and pushed to main

2. Create and push a new tag:

   git tag v0.2.0
   git push origin v0.2.0

3. GitHub Actions will automatically:

   • Run tests
   • Build binaries for all platforms (macOS, Linux, Windows)
   • Create a GitHub release with the binaries
   • Publish to npm (@dosu/cli)
   • Update the Homebrew formula

Version Naming

• Production releases: v1.0.0, v1.1.0, v2.0.0
• Pre-releases: v0.1.0-alpha, v0.1.0-beta, v0.1.0-rc1

Pre-release tags (containing -alpha, -beta, -rc) are automatically marked as pre-releases on GitHub and published to npm under the next dist-tag.