hub / github.com/0xferrous/agent-box
github.com/0xferrous/agent-box @main
Chat with this repo
368 symbols
876 edges
24 files
70 documented · 19%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
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:
Table of Contents
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'
Extension points exported contracts — how you extend this code
ContainerBackend (Interface)Internal trait for runtime implementations [2 implementers]
ab/src/runtime/docker.rs
Core symbols most depended-on inside this repo
make_test_configcalled by 29
common/src/config.rs
resolve_profiles
called by 23
common/src/config.rs
build_figment
called by 20
common/src/config.rs
ok
called by 17
common/src/portal.rs
add_mounts
called by 16
ab/src/runtime/mod.rs
parse_single_cli_mount
called by 14
ab/src/runtime/mod.rs
validate_config
called by 11
common/src/config.rs
to_resolved_mounts
called by 9
common/src/config.rs
Shape
Languages
Rust98%
Python1%
TypeScript1%
Modules by API surface
common/src/config.rs107 symbols
ab/src/runtime/mod.rs76 symbols
common/src/portal.rs41 symbols
portal/src/host.rs28 symbols
common/src/path.rs27 symbols
common/src/repo.rs18 symbols
common/src/portal_client.rs10 symbols
wrappers/src/bin/wl-paste.rs7 symbols
portal/tests/host_integration.rs7 symbols
ab/src/runtime/docker.rs7 symbols
ab/src/main.rs7 symbols
portal/src/logging.rs6 symbols
For agents
$ claude mcp add agent-box \
-- python -m otcore.mcp_server <graph>