Skip to main content
Release: 0.1.0a4. Use the Python interpreter from your installed virtual environment. The examples below use python to denote that interpreter; installation gives explicit Windows and Linux paths.

Command overview

Context assembly, project reviews, memory saving, memory transport, and message publication remain Python APIs. There are no peoplebot start-agent or peoplebot schedule commands; installation does not activate anything.

resolve-state

A branch name, abbreviated SHA, or absolute filesystem path is not valid in the corresponding commit/path field. Resolution reads Git objects, not working-tree edits, and does not fetch absent commits. Successful output is JSON on standard output. Classified errors are written to standard error. The CLI returns 0 on success, 2 for invalid input, 3 for State resolution failures, and 4 for alpha-operation failures. These codes do not cover every possible unhandled operating-system or Python failure. See the complete first-State example.

Alpha commands

These expose a synthetic local experiment. They do not provision GitHub accounts, install model runtimes, discover releases, create production agents, or activate schedules. All three require caller-supplied environment checkout/repository, environment identity, and Instance identity. Setup takes exact framework paths and a creation timestamp. Adoption additionally takes an existing selection commit, a candidate framework selection, runtime root, execution identity, and timestamps. Resume takes exact selection/memory commits, source checkouts, and one or more requested memory paths. Use each command’s --help and the exact alpha contract for the full input set. Guessing bindings or substituting a mutable branch for a pinned State defeats the experiment’s purpose.

Public reference

CLI source, Instance operating model.