actor.sh

Getting started

Install actor.sh, register it with Claude Code, and spawn your first actor.

The pages here walk you from a fresh machine to a running orchestrator session with verified actors. Read them in order the first time — each builds on the previous one.

  • Introduction — what actor.sh is, the problem it solves, and the shape of an orchestrator session.
  • Installation — install the actor package, register the skill and MCP server with Claude Code, and verify the wiring.
  • Your first actor — launch actor main, ask it to spawn a sub-actor, and inspect the result end-to-end.
  • The watch dashboard — tour the actor watch TUI: master-detail layout, status icons, navigation, and embedded interactive sessions.

Once you’re comfortable, the Concepts section explains the underlying model — actors and worktrees, roles, hooks, ask blocks, and channel notifications.

  • Introduction What actor.sh is and why it exists.
  • Installation Get actor.sh installed and registered with Claude Code.
  • Your first actor Launch the orchestrator, spawn an actor, and inspect the work it did.
  • The watch dashboard Tour the Textual TUI for live actor status, logs, diffs, and embedded sessions.