Get Started

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 | resolve

Run 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