Installation

Prerequisites

• Bun v1.3.8+ (required for building from source)
• At least one supported AI coding agent installed and on your $PATH:
  • claude (Claude Code)
  • opencode (OpenCode)
  • codex (Codex)

Install script (recommended)

The fastest way to install ody. The script auto-detects your OS and architecture, fetches the latest release binary, and places it on your system:

curl -fsSL https://raw.githubusercontent.com/8bittitan/ody/main/install.sh | sh

By default the binary is installed to $HOME/.local/bin. To customize the install location, set ODY_INSTALL_DIR:

ODY_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/8bittitan/ody/main/install.sh | sh

Download a release binary

Pre-built binaries are available on the GitHub Releases page. Download the binary for your platform:

After downloading, make it executable and move it to a directory on your $PATH:

chmod +x ody-darwin-arm64
mv ody-darwin-arm64 /usr/local/bin/ody

Build from source

Requires Bun v1.3.8+.

git clone https://github.com/8bittitan/ody.git
cd ody
bun install
bun run build

The compiled binary is output to packages/cli/dist/ody. You can move it to a directory on your $PATH or run it directly:

./packages/cli/dist/ody --help