🐾 PeopleClaw CLI

Workflow engine for SMEs — manage workflows, cases & human-in-the-loop steps from terminal or LLM agents.

PeopleClaw is a workflow engine designed for small and medium businesses where humans are part of the loop — approvals, reviews, manual checks. The CLI lets you (or your LLM agent) drive workflows from anywhere a terminal lives.

Status: v0.1.0 — CLI skeleton. Commands are wired but not yet connected to a live PeopleClaw server. The shape is stable; the wires come next.

Install

npm i -g peopleclaw

Verify:

peopleclaw --help

Quick Start

# 1. Point the CLI at your PeopleClaw server
peopleclaw config set --api-url https://api.peopleclaw.com --token sk_xxx

# 2. Browse available workflows
peopleclaw workflows list
peopleclaw workflows get wf_invoice_approval

# 3. Kick off a case
peopleclaw cases create --workflow wf_invoice_approval --input '{"amount": 1200, "vendor": "Acme"}'

# 4. Track progress
peopleclaw cases list --status pending
peopleclaw cases get case_abc123

# 5. Advance a human step (approve / reject)
peopleclaw cases advance case_abc123 --step manager_review --action approve --data '{"note":"LGTM"}'

Commands

Workflows

| Command | Description | | --- | --- | | peopleclaw workflows list | List all available workflows | | peopleclaw workflows get <id> | Show a workflow's definition |

Cases

| Command | Description | | --- | --- | | peopleclaw cases create --workflow <id> [--input <json>] | Start a new case | | peopleclaw cases get <id> | Show case state and step history | | peopleclaw cases list [--status <status>] | List cases, optionally filtered | | peopleclaw cases advance <id> --step <stepId> --action <approve\|reject> [--data <json>] | Advance a human-in-the-loop step |

Config

| Command | Description | | --- | --- | | peopleclaw config set --api-url <url> --token <token> | Save endpoint and token | | peopleclaw config show | Print current config (token redacted) |

Config is stored at ~/.peopleclaw/config.json.

Connecting to a PeopleClaw Server

PeopleClaw server is under active development. Once available, you'll get an API URL and token from your workspace settings, then run:

peopleclaw config set --api-url https://YOUR-WORKSPACE.peopleclaw.com --token YOUR_TOKEN

Until then, commands will print a friendly "not yet connected" notice — the CLI surface is stable for scripting against.

Why PeopleClaw?

• Humans-first. Most workflow engines treat humans as exceptions. PeopleClaw treats them as first-class steps.
• LLM-friendly. A clean CLI means LLM agents can drive workflows the same way humans do.
• Built for SMEs. No enterprise weight. Spin up a workflow in minutes.

Roadmap

• [x] CLI skeleton (v0.1.0)
• [ ] Live API integration
• [ ] Real-time case watching (cases watch)
• [ ] Inline approvals via deep links
• [ ] Workflow authoring helpers

License

MIT © Exis Zhang