Holon

A local workbench for agents doing continuous work with explicit waits, wakes, state, and trust boundaries.

Guides

Guides are organized by user job — find your goal and follow the path.

Evaluate and try Holon

Start here if you want to see what Holon can do with minimal setup.

  • Quick examples — one-shot commands, agent creation, model configuration, daemon and TUI basics.
  • Local runtime — conservative workflow for running and inspecting Holon from source.

Automate GitHub work

  • holon solve — headless automation for GitHub issues and pull requests with automatic skill dispatch.

Operate and configure

Keep a running Holon instance healthy and configured.

  • Troubleshooting — diagnose daemon, model, configuration, and TUI issues in likely encounter order.

Integrate and automate

Wire Holon into external systems through its control plane.

  • Integration guide — HTTP control plane with curl examples and endpoint reference.

Collaborate and delegate

Work with multiple agents, durable objectives, and reusable skills.

  • Multi-agent collaboration — spawning child agents, supervision contracts, and workspace modes.
  • Work items guide — tracking durable objectives with plans, todo lists, and lifecycle management.
  • Durable agent workflow — the end-to-end durable agent story: WorkItems, wait/wake/resume, and final briefs.
  • Skills guide — reusable SKILL.md workflows, skill locations, and custom skill development.

Contribute to these docs

Edit and build the Holon documentation website.

Durable agent workflowThe end-to-end durable agent story: create an agent, start long-running work, survive disconnects, wait for events, and deliver final briefs.holon solveUse holon solve to automate GitHub issues and pull requests in headless mode.Local runtimeA conservative workflow for running and inspecting Holon locally.TUI guideInteractive terminal UI for Holon — navigation, slash commands, event log, model selection, and remote connection.Quick examplesCommon Holon tasks you can try after completing the Getting Started guide.WorkspacesWorkspace lifecycle — attach, exit, detach, worktree isolation, and how workspaces differ from shell directories.Agent templatesWhat agent templates are, available built-in templates, how to use --template, and how to create custom templates.Documentation workflowHow to edit and build the mdorigin-powered Holon website.Remote accessRemote daemon access — tunnel, tailnet, LAN modes, token management, and connecting from a remote TUI.Integration guideProgrammatic access to Holon's HTTP control plane with curl examples and endpoint reference.