---
title: Guides
summary: Task-oriented guides grouped by what you want to do with Holon.
order: 30
---

# 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](/guides/quick-examples)** — one-shot commands, agent
  creation, model configuration, daemon and TUI basics.
- **[Local runtime](/guides/local-runtime)** — conservative workflow for
  running and inspecting Holon from source.

## Automate GitHub work

- **[holon solve](/guides/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](/guides/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](/guides/integration)** — HTTP control plane with
  curl examples and endpoint reference.

## Collaborate and delegate

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

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

## Contribute to these docs

Edit and build the Holon documentation website.

- **[Documentation workflow](/guides/documentation-workflow)** — how to edit
  and build the mdorigin-powered Holon website.

<!-- INDEX:START -->

- [Durable agent workflow](./durable-agent-workflow.md)
  The end-to-end durable agent story: create an agent, start long-running work, survive disconnects, wait for events, and deliver final briefs.
  <!-- mdorigin:index kind=article -->

- [holon solve](./solve.md)
  Use holon solve to automate GitHub issues and pull requests in headless mode.
  <!-- mdorigin:index kind=article -->

- [Local runtime](./local-runtime.md)
  A conservative workflow for running and inspecting Holon locally.
  <!-- mdorigin:index kind=article -->

- [TUI guide](./tui.md)
  Interactive terminal UI for Holon — navigation, slash commands, event log, model selection, and remote connection.
  <!-- mdorigin:index kind=article -->

- [Quick examples](./quick-examples.md)
  Common Holon tasks you can try after completing the Getting Started guide.
  <!-- mdorigin:index kind=article -->

- [Workspaces](./workspaces.md)
  Workspace lifecycle — attach, exit, detach, worktree isolation, and how workspaces differ from shell directories.
  <!-- mdorigin:index kind=article -->

- [Agent templates](./agent-templates.md)
  What agent templates are, available built-in templates, how to use --template, and how to create custom templates.
  <!-- mdorigin:index kind=article -->

- [Documentation workflow](./documentation-workflow.md)
  How to edit and build the mdorigin-powered Holon website.
  <!-- mdorigin:index kind=article -->

- [Remote access](./remote-access.md)
  Remote daemon access — tunnel, tailnet, LAN modes, token management, and connecting from a remote TUI.
  <!-- mdorigin:index kind=article -->

- [Integration guide](./integration.md)
  Programmatic access to Holon's HTTP control plane with curl examples and endpoint reference.
  <!-- mdorigin:index kind=article -->

- [Troubleshooting](./troubleshooting.md)
  Solutions for common Holon issues covering daemon, configuration, model, and TUI problems.
  <!-- mdorigin:index kind=article -->

- [Multi-agent collaboration](./multi-agent.md)
  Spawning child agents, supervision contracts, and workspace modes for parallel work.
  <!-- mdorigin:index kind=article -->

- [Skills guide](./skills.md)
  Reusable SKILL.md workflows, skill locations, and how to develop custom skills.
  <!-- mdorigin:index kind=article -->

- [Work items guide](./work-items.md)
  Durable objective tracking with work items, plans, todo lists, and lifecycle management.
  <!-- mdorigin:index kind=article -->

<!-- INDEX:END -->