Documentation

Get running in fifteen minutes

Install the desktop app, connect a project, add a member. Every stage starts gated, so nothing runs unattended while you are still deciding whether you trust it.

Quickstart

1 · Install

Alicorn is a desktop app. Download the installer, open it, then install the agent hooks on every host you use.

alicorn hooks install --local --wsl --ssh

2 · Connect a project

Point Alicorn at a repository and a tracker. Worktrees are created under a directory you choose; the tracker sync runs both ways.

alicorn project add --repo [email protected]:acme/payments.git \
                    --tracker plane --url https://plane.acme.internal

3 · Create a member

A member is a role bound to a backend, a skill set and a workspace kind.

alicorn member create "Code Review" \
  --backend codex \
  --skills code-review,security-review \
  --workspace worktree \
  --permission accept-edits

4 · Author a workflow

Stages, owners and triggers. Mark which stages are irreversible or carry an inherited decision: those are the gates that never retire.

alicorn workflow create "Feature delivery"
alicorn stage add build  --member Developer   --reversibility contained \
                         --checks "pnpm test,tc:node,oxlint"
alicorn stage add review --member "Code Review" --reversibility contained
alicorn stage add merge  --reversibility irreversible

Reference

CLI

The same runtime as the desktop app, headless. Agents use it too: it is how a member creates a worktree or hands work to the next stage.

Command	What it does
`alicorn member`	Create, list and edit members
`alicorn workflow`	Author workflows and stages
`alicorn worktree`	Create and manage isolated worktrees
`alicorn orchestration`	Runs, tasks, dispatch, gates, evidence
`alicorn policy`	Read and set autonomy policy per stage
`alicorn trail`	Read and export the decision trail
`alicorn skills`	Install and share skills from the org catalog
`alicorn hooks`	Install agent hooks on local, WSL and SSH hosts

Reading the trail

Ask why a step ran without you. Every line is a recorded fact.

$ alicorn trail show PAY-3021 --stage build

Build → Review                                    auto-approved
  verified        3/3 required checks passed
  reversible      isolated worktree feat/PAY-3021 · not merged
  blast radius    14 files (limit 25) · $0.82 (limit $5.00)
  track record    Developer · 71 runs · 96.1% accepted unchanged
  policy          evidence · level 3 autonomous

$ alicorn trail export --run run_8f21c4 --format json --signed