Installation

Agent Harbor runs on macOS and Linux.

Install via Nix

Prerequisites

• Nix  with flake support enabled

Install Nix

If you don’t have Nix installed:

curl -L https://nixos.org/nix/install | sh

After installation, enable flake support by adding to ~/.config/nix/nix.conf:

experimental-features = nix-command flakes

Install Agent Harbor

nix profile install github:blocksense-network/agent-harbor

Building from Source

Prerequisites

• Nix with flake support (provides all build dependencies)
• Git

Clone and Build

git clone https://github.com/blocksense-network/agent-harbor.git
cd agent-harbor
direnv allow  # or: nix develop
cargo build --bin ah

The binary will be at ./target/debug/ah.

For a release build:

cargo build --release --bin ah

The release binary will be at ./target/release/ah.

Verify Installation

ah --version

Check System Health

Run the health check to verify your setup:

ah health

This checks:

• Agent availability and credentials
• Filesystem snapshot provider support
• Terminal multiplexer detection

Agent Credentials

Agent Harbor uses each agent’s native credential system. Before using an agent, authenticate with it directly:

Claude Code

claude
# Follow the authentication prompts

OpenAI Codex

codex auth

Verify Credentials

ah health

The health check will show which agents have valid credentials configured.