What Orbit Is

v0.9.2 · early access

The audit log for your AI coding agents.

Durable task lifecycle, task-attributed workflow commits, and structured audit records for agent workflows. Local-first, bring your own model provider.

$ npm install -g @orbit-tools/cli Copy

Install Orbit → Read the CLI reference

Runs your provider CLI Claude Code Codex Gemini Grok Build

~/repo one task, end to end

$ orbit task add --title "Document fsProfile resolution" \

--acceptance-criteria "..." --complexity medium

[TASK_ID]

$ orbit run ship "$TASK_ID"

submitted · run [RUN_ID]

$ orbit run show

step scope status duration

plan worktree: iso ok 00:12

edit fsProfile: docs ok 01:47

test fsProfile: docs ok 02:03

pr github ok 00:09

$ git log -1 --grep "$TASK_ID" --oneline

[SHA] docs: document fsProfile resolution

Start here

Install

One binary, no Rust toolchain. Then orbit init sets up your root and skills.

orbit init

Write a task

Acceptance criteria are required — agents self-evaluate against them.

orbit task add --title "…"

Ship it

The gated pipeline opens a PR, or stays local with --mode local.

orbit run ship "$TASK_ID"

Why Orbit

Auditable

Task mutations, workflow events, provider turns, and tool calls emit joined audit records, redacted at write time.

Intent-attributed

Workflow commits carry the allocated task ID, so git log --grep links code history back to the task record.

Local-first

Task and run state stay in your Orbit roots. Provider CLIs handle model traffic using your own provider accounts.

Safe parallel

Worktree isolation and filesystem policies (sandbox-exec, bwrap) keep parallel agents from colliding.

Explore the docs

Getting Started

Install Orbit First Task Default Workflows

Concepts

Tasks Activities and Jobs Policies Agents

How-to Guides

Run a Task Lifecycle Write an Activity Choose Scopes Set Up MCP

Reference

CLI Commands Activity and Job YAML Policy Format Configuration Scoping Rules

Architecture

Overview

Contributing

Local Development Crate Layout PR Workflow