Installation

Install Codiv from source and verify it is working.

Prerequisites

Before installing Codiv, make sure you have:

• An LLM API key from at least one supported provider:
  • Anthropic (Claude)
  • OpenAI (GPT)
  • Google (Gemini)

Quick Install

The fastest way to install Codiv:

curl -fsSL https://codiv.ai/install.sh | bash

This will:

1. Download the latest release for your platform
2. Install codiv and codivd to ~/.local/bin/
3. Add ~/.local/bin to your PATH (if needed)
4. Start the codivd daemon as a system service

To install a specific version:

curl -fsSL https://codiv.ai/install.sh | bash -s -- v0.1.0

Uninstall

macOS:

launchctl bootout gui/$(id -u)/ai.codiv.daemon
rm ~/Library/LaunchAgents/ai.codiv.daemon.plist
rm ~/.local/bin/codiv ~/.local/bin/codivd

Linux:

systemctl --user disable --now codivd.service
rm ~/.config/systemd/user/codivd.service
systemctl --user daemon-reload
rm ~/.local/bin/codiv ~/.local/bin/codivd

Homebrew (macOS / Linux)

Install via Homebrew:

brew tap razorback16/codiv https://github.com/razorback16/codiv.git
brew install codiv

This installs both codiv (TUI client) and codivd (daemon).

To run the daemon as a managed service:

brew services start codiv

Cargo Install (from Git)

If you have the Rust toolchain installed:

cargo install --git https://github.com/razorback16/codiv.git codiv
cargo install --git https://github.com/razorback16/codiv.git codivd

Both commands are needed — codiv is the TUI client and codivd is the daemon it connects to.

Build from Source

Clone the repository and build all workspace crates:

git clone https://github.com/razorback16/codiv.git
cd codiv
cargo build --workspace --release
ln -sf "$(pwd)/target/release/codiv" ~/.local/bin/codiv
ln -sf "$(pwd)/target/release/codivd" ~/.local/bin/codivd

This compiles the codiv client, codivd daemon, and all shared library crates, then symlinks both binaries to your PATH.

Verify

Confirm the installation worked:

codiv --help

You should see the Codiv help output listing available subcommands and flags. If you see a “command not found” error, make sure ~/.local/bin is on your PATH.

Next Steps

Head to the Quick Start guide to launch Codiv and try your first commands.