Installation

Installation

Codive can be installed on macOS, Linux, and Windows. Choose your preferred installation method below.

Quick Install

Cargo

If you have Rust installed, the easiest way to install Codive is via Cargo:

cargo install codive

This installs the latest stable version from crates.io.

Homebrew

On macOS or Linux with Homebrew:

brew install codive

Script

One-line install script for macOS and Linux:

curl -fsSL https://codive.dev/install.sh | sh

This script detects your OS and architecture, downloads the appropriate binary, and installs it to ~/.local/bin.

Windows

On Windows with Scoop:

scoop install codive

Or download the .exe from GitHub Releases.

Building from Source

1. Clone the repository

   git clone https://github.com/toliaqat/codive.git
   cd codive

2. Build with Cargo

   cargo build --release

3. Install the binary

   cargo install --path crates/agent-cli

Requirements

Minimum Requirements

• Rust 1.75+ (if building from source)
• Operating System: macOS 12+, Ubuntu 20.04+, Windows 10+
• Architecture: x86_64 or ARM64

API Keys

Codive requires an API key from an LLM provider. Currently supported:

Provider	Environment Variable	Get API Key
Anthropic	ANTHROPIC_API_KEY	console.anthropic.com
OpenAI	OPENAI_API_KEY	platform.openai.com

Set your API key in your shell:

# For Anthropic Claude (recommended)
export ANTHROPIC_API_KEY="sk-ant-..."

# For OpenAI GPT-4
export OPENAI_API_KEY="sk-..."

Tip

Add this to your ~/.bashrc, ~/.zshrc, or shell config file to persist across sessions.

Verify Installation

After installation, verify Codive is working:

codive --version

You should see output like:

codive 0.1.0

Configuration

Codive looks for configuration in the following locations (in order):

1. ./codive.toml (project-specific)
2. ~/.config/codive/config.toml (user config)
3. Environment variables

Example configuration file:

~/.config/codive/config.toml

[provider]
name = "anthropic"
model = "claude-sonnet-4-20250514"

[agent]
max_iterations = 50
confirm_writes = true

[tools]
enabled = ["read", "write", "bash", "glob", "grep"]

Updating

To update Codive to the latest version:

Cargo

cargo install codive --force

Homebrew

brew upgrade codive

Script

Run the install script again:

curl -fsSL https://codive.dev/install.sh | sh

Troubleshooting

Command not found

If codive is not found after installation, ensure the install directory is in your PATH:

# For Cargo installs
export PATH="$HOME/.cargo/bin:$PATH"

# For script installs
export PATH="$HOME/.local/bin:$PATH"

API Key Issues

If you get authentication errors:

1. Verify your API key is set: echo $ANTHROPIC_API_KEY
2. Check the key is valid at your provider’s dashboard
3. Ensure there are no extra spaces or quotes around the key

Permission Denied

On Linux/macOS, you may need to make the binary executable:

chmod +x ~/.local/bin/codive

Next Steps

Now that Codive is installed, continue to the Quick Start guide to learn the basics.