---
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.
- **[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 -->

- [Local runtime](./local-runtime.md)
  A conservative workflow for running and inspecting Holon locally.
  <!-- 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 -->

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

- [Documentation workflow](./documentation-workflow.md)
  How to edit and build the mdorigin-powered Holon website.
  <!-- 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 -->
