Agent-box

Agent-box provides sandboxed development workflows for coding agents, plus optional Portal-based host capability mediation.

[!NOTE] This repository now uses the mdBook docs site as the primary documentation source.

Demo

Documentation

Read the docs in one of these ways:

• Build locally: nix develop --command 'mdbook build docs'
• Open generated site: docs/book/index.html

Entry points:

• Start here
• Choose your path
• Tutorials
• How-to guides
• Reference
• Explanation + ADRs

Table of Contents

• Demo
• Documentation
• Quick links
• Development

Quick links

• Agent-box first run
• Agent-box profiles guide
• Portal standalone first run
• Connect Portal to Agent-box
• Agent-box config reference
• Agent-box requirements
• Agent-box workflow internals
• Agent-box CLI reference (generated)
• Portal CLI reference (generated)

Related projects

• agent-images - Reproducible OCI container images for AI coding agents, built with Nix. Consumes agent packages from llm-agents.nix and produces images usable with agent-box or standalone Podman/Docker.

Development

From the repo root, run checks in the flake devshell:

The flake also preconfigures the 0xferrous Cachix cache via nixConfig, and CI pushes the ab, wrappers, and portal flake outputs there.

nix develop --command cargo fmt --all
nix develop --command cargo check --workspace
nix develop --command cargo clippy --workspace --all-targets -- -D warnings

Regenerate CLI reference pages:

nix develop --command nix-shell -p nushell --run 'nu docs/scripts/generate-cli-reference.nu'