Holon

Agents that act and follow through. Run Holon on your computer or a team server. Connect events and schedules so agents can act, save progress, and ask for your input when needed.

Reference

Reference pages describe Holon's current public surface as it actually behaves β€” not as it is planned or promised. They are verified against the compiled runtime (holon --help, holon config schema, route inventory) where applicable, and pages that document a tool or feature name their maintenance source. They are the authoritative single source of truth for syntax and options.

What is covered

  • Command-line interface: Command tree, flags, parameters, and exit codes.
  • Configuration: Configuration files, schema validation, and environment variables.
  • HTTP control plane: REST endpoints, authentication tokens, and payload definitions.
  • Models & tools: Provider catalogs, model support, and built-in tool schemas.

Tutorials and step-by-step instructions belong in Guides. Internal engine mechanics belong in Runtime specs.

Stability note: The runtime is pre-1.0. CLI shapes, config keys, and HTTP endpoints may change without prior notice. Each reference page records the version it was last regenerated against where applicable. See the repository RFC index for design direction and stability status.

Hand-written pages vs generated baselines

Hand-written pages are verified against a runtime artifact and record the version they were last checked against. Generated pages and machine-readable baselines are refreshed from source instead of edited here.

PageSource of truthRefresh
cli.mdholon --helpregenerate when the command tree changes
configuration.mdholon config schema, holon config listre-verify when config keys change
http-control-plane.mdAxum route tree, OpenAPI 3.1 schema (openapi.json)re-verify when routes or payloads change
models.mdgenerated from src/model_catalog.rscargo run --bin holon-docgen -- models > docs/website/reference/models.md, then python3 docs/website/.tools/sync-generated-pages.py
*-inventory.md, *-inventory.jsongenerated JSON baselinesmake snapshots-refresh, then review the diff
CLI referenceHolon's command-line interface β€” verified against holon --help (v0.50.0).CLI contract inventoryFirst-pass stability inventory for Holon's command-line parameters, outputs, and follow-up contract work.CLI stability policySupport policy for Holon's command-line surfaces and machine-readable output contracts.CLI exit codesExit-code and stream-routing contract for Holon's command-line interface.ConfigurationHolon configuration files, keys, credentials, environment variables, and diagnostics.HTTP control planeHow to think about Holon's headless integration surface.API contract inventoryPost-baseline stability inventory for Holon's HTTP control-plane API parameters, responses, and Phase 2 contract work.Model tool schema inventoryVersioned inventory for Holon's model-facing built-in tool schemas, result envelopes, and stability labels.Runtime status enum inventoryMachine-readable baseline for stable serialized runtime lifecycle and status enums.Workspaces and execution environmentsWorkspace, execution root, and worktree binding, switching, and isolation contracts.