agentctl

Overview ¶

Command agentctl is the client-facing CLI for agentsessions — the top seam a user or GitHub drives. By default it runs an EMBEDDED Sessions gRPC server over a local unix socket (backed by a sqlite journal on disk) and connects to it as a real gRPC client — not an in-process wrapper — so the same code path serves remote. Pass --server <addr> to drive a remote controller instead.

agentctl create  --name "triage" --project acme
agentctl list    --project acme           # enumerate sessions, newest first
agentctl exec    --input "hi"            # create + run a turn (prints the session UID)
agentctl exec    --session <uid> --input "..."
agentctl replay  --session <uid>          # re-deliver the committed log
agentctl fork    --session <uid> --at N    # branch into a child session
agentctl suspend --session <uid>
agentctl resume  --session <uid>
agentctl delete  --session <uid>          # permanent intent only; compute/pins retained
agentctl approve <uid>                  # commit approval, then Resume
agentctl deny    <uid> --reason "no"    # commit denial, then Resume
agentctl harness register --server 127.0.0.1:8081 --name mine --spec spec.json
agentctl harness get|list|retire --server 127.0.0.1:8081 [flags]