Command reference
The current Epismo command hierarchy at a glance.
epismo login | logout | whoami | doctor | examples | completion | docs
epismo workspace list | current | use | clear | create | checkout | update
epismo workspace member list | upsert | delete
epismo team list | create | update
epismo team member list | add | delete
epismo credit balance | checkout
epismo token create | list | revoke
epismo playbook init | search | list | create | get | access get | set | archive | star | unstar | starred
epismo playbook version list | get | archive | publish
epismo playbook draft get | save | discard | publish
epismo playbook suggestion create | list
epismo playbook share <playbook-id>
epismo playbook alias set | list | delete
epismo case start | get | list | assign | acl | update | handoff | handoff graph | close | reopen
epismo case task create | list
epismo case record append | list
epismo task list | get | assign | update | close | reopen
epismo suggestion get | list | update | resolveRun epismo <command> --help for positional arguments, flags, accepted values, examples, and defaults. Use epismo <command> --schema for a machine-readable option summary. Complex inputs support --input <json>, --input @file, or --input -; explicit flags take precedence. On list and search commands, --input supplies query parameters.
Global options may appear before or after a command: --workspace/-w <id-or-handle>, --output/-o json|table|yaml|jsonl|value, --diagnostic-format json|human, --field, --jq, --dry-run, and --yes/-y. Paging commands support --page-size, --cursor, --all, and --limit. Mutation commands accept --idempotency-key; the CLI generates one when it is omitted. Case and Task mutations that change existing state require --lock-version.
Archive, delete, revoke, close, ACL-replacement, and workspace-clear operations ask for confirmation in an interactive terminal. Use --dry-run to preview one without sending a request, or --yes to skip the prompt.
Common constrained values include:
| Field | Values |
|---|---|
| Playbook category | productivity, programming, design, sales, marketing, operations, learning |
| Case status | open, closed |
| Case outcome | completed, cancelled, abandoned |
| Handoff scope | self, ancestors, descendants, neighbors, connected |
| Task kind | work, review |
| Task status | open, closed |
| Record origin | user, agent, system |
| Record order | asc, desc |
| Suggestion status | open, applied, declined, archived |