holon 0.14.1

A headless, event-driven runtime for long-lived agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

---
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 -->

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

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

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

<!-- INDEX:END -->