Install

The rensei CLI is a single binary for macOS and Linux that combines the full open-source donmai command surface with platform-specific authentication, fleet management, and workflow tooling. This page covers all supported install paths.

Homebrew (recommended)

Homebrew is the fastest path on macOS and Linux. The cask is published to RenseiAI/homebrew-tap on every tagged release via GoReleaser.

brew install RenseiAI/tap/rensei

Verify the install succeeded:

rensei --version

You should see output like rensei v0.8.x (commit abc1234, darwin/arm64).

If you already have the donmai binary from the open-source donmai runner, rensei is a strict superset - you can keep both side-by-side. The rensei binary imports all donmai commands and extends them with platform-specific subcommands.

Pre-built binary

Codesigned and notarized binaries (Apple Developer ID) for all supported platforms are attached to every GitHub release at github.com/RenseiAI/releases.

curl -fsSL https://github.com/RenseiAI/releases/releases/latest/download/rensei_darwin_arm64.tar.gz \
  | tar -xz -C /usr/local/bin rensei
chmod +x /usr/local/bin/rensei
rensei --version

curl -fsSL https://github.com/RenseiAI/releases/releases/latest/download/rensei_darwin_amd64.tar.gz \
  | tar -xz -C /usr/local/bin rensei
chmod +x /usr/local/bin/rensei
rensei --version

curl -fsSL https://github.com/RenseiAI/releases/releases/latest/download/rensei_linux_arm64.tar.gz \
  | tar -xz -C /usr/local/bin rensei
chmod +x /usr/local/bin/rensei
rensei --version

curl -fsSL https://github.com/RenseiAI/releases/releases/latest/download/rensei_linux_amd64.tar.gz \
  | tar -xz -C /usr/local/bin rensei
chmod +x /usr/local/bin/rensei
rensei --version

Build from source

Source access is restricted to internal contributors. Only compiled binaries are distributed publicly.

If you have access to the private rensei-tui repository:

make build   # produces bin/rensei

What gets installed

The rensei binary is self-contained - no runtime dependencies. On first run it creates two directories:

Path	Purpose
`~/.config/rensei/`	CLI configuration (`config.json`)
`~/.rensei/`	Daemon config, JWT cache, and logs

These directories are created lazily. If you plan to run the local daemon, rensei host install provisions the necessary files when you first register your machine.

Shell completions

Generate shell completions and install them into your shell's config directory:

rensei completion zsh > "${fpath[1]}/_rensei"
# Then reload your shell or run: source ~/.zshrc

rensei completion bash > /etc/bash_completion.d/rensei
# Or for a user-local install:
rensei completion bash >> ~/.bash_completion

rensei completion fish | source
# To persist, write it to your completions dir:
rensei completion fish > ~/.config/fish/completions/rensei.fish

Next steps

Upgrade - keep rensei current and understand the plist rename caveat
Quick start - run the setup wizard and connect GitHub/Linear in minutes
Auth - understand user, org-token, and project-token contexts