Skip to main content

Build from Source

For contributors and local development only. End users should install with the curl script:

curl -fsSL https://agentmesh.sh/install.sh | sh

Prerequisites​

  • Rust 1.85+ — the repo pins the toolchain via rust-toolchain.toml
  • Git
  • A C linker (provided by Xcode Command Line Tools on macOS, build-essential on Debian/Ubuntu)

Clone and build​

git clone https://github.com/aranticlabs/agentmesh.git
cd agentmesh
cargo build --release -p agentmesh

The binary is at target/release/agentmesh.

Verify:

./target/release/agentmesh --version
./target/release/agentmesh --help

Add to PATH​

Pick one approach:

Temporary (current shell)​

export PATH="$PATH:/path/to/agentmesh/target/release"

Permanent — copy to a bin directory​

cp target/release/agentmesh ~/.local/bin/
# ensure ~/.local/bin is on your PATH

Cargo install (local)​

cargo install --path crates/agentmesh

This installs to ~/.cargo/bin/agentmesh.

Development builds​

For faster iteration during development:

cargo build -p agentmesh
./target/debug/agentmesh --help

Run the project's quality checks before contributing:

cargo fmt --all
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace --all-features

Upgrade​

Pull latest changes and rebuild:

cd agentmesh
git pull
cargo build --release -p agentmesh

If AgentMesh is already initialized in a repo, repin hooks to the new binary:

cd /path/to/your/repo
agentmesh upgrade

Next step​

Initialize AgentMesh in a repository: Quick Start.