v0.3 Public Preview

Run Agents.
Get Patches.
Ship PRs.

Holon runs AI coding agents headlessly to turn issues into PR-ready patches and summaries — locally or in CI, without babysitting the agent.

Headless by default. Sandboxed execution. Standardized artifacts. Pluggable agents.

Get Started on GitHub See Quickstart

$ holon solve owner/repo#123
Initializing sandbox... done
Running agent (claude-3.5-sonnet)...
Artifacts generated:
📄 diff.patch, summary.md
Applying patch and creating PR...
✔ PR created successfully!
🔗 https://github.com/owner/repo/pull/124
$ _

Quickstart

Get started with Holon in GitHub Actions or run it locally with the CLI.

# .github/workflows/holon-trigger.yml
name: Holon Trigger

on:
  issue_comment:
    types: [created]
  issues:
    types: [labeled, assigned]
  pull_request:
    types: [labeled]

permissions:
  contents: write
  issues: write
  pull-requests: write
  id-token: write

jobs:
  holon:
    name: Run Holon (via holon-solve)
    uses: holon-run/holon/.github/workflows/holon-solve.yml@main
    with:
      issue_number: ${{ github.event.issue.number || github.event.pull_request.number }}
      comment_id: ${{ github.event.comment.id }}
    secrets: inherit

Setup: Install the holonbot GitHub App and set the ANTHROPIC_AUTH_TOKEN secret in your repository.

# Install via Homebrew
brew install holon-run/tap/holon

# Or download from GitHub Releases
# https://github.com/holon-run/holon/releases

# Set environment variables
export ANTHROPIC_AUTH_TOKEN=...
export GITHUB_TOKEN=...  # or use: gh auth login

# Run against an issue or PR
holon solve https://github.com/owner/repo/issues/123
# or: holon solve owner/repo#456

Behavior: For issues, Holon creates/updates a branch + PR. For PRs, it applies/pushes the patch to the PR branch.

Why Holon?

AI coding agents are powerful, but shipping software requires repeatability, review, and validation.

🎯

Headless by Default

Run AI coding agents end-to-end without TTY or human input. Deterministic, repeatable runs every time.

📦

Patch-First Artifacts

Always produce diff.patch, summary.md, and manifest.json for review and CI integration.

🔒

Sandboxed Execution

Docker + snapshot workspaces by default. Nothing touches your repo unless you opt in.

🔄

Issue → PR, End to End

Fetch context, run the agent, and create or update a PR in one command. Local or CI, same run.

🔌

Pluggable Agents

Swap agent engines or bundles without changing your workflow. No model or vendor lock-in.

⚙️

Local or CI, Same Run

holon solve locally or in GitHub Actions with identical inputs and outputs.

How It Works

Holon doesn't replace your workflow. It slots into it.

Trigger

Issue or PR

→

Snapshot

Clone Sandbox

→

Run Agent

Headless Run

→

Artifacts

diff.patch

→

Ship

Push PR

Start running agents like real engineering work.

Holon doesn't generate code. It ships work.

Get Started on GitHub

Run Agents.Get Patches.Ship PRs.