Get Started

CLI

The complete agent-friendly surface for Epismo from a terminal or CI job.

The epismo CLI covers Playbooks, Versions, Cases, Tasks, Records, Suggestions, aliases, stars, workspaces, teams, members, credits, and automation tokens. JSON remains the default output for scripts and agents; use --output table, yaml, jsonl, or value when working interactively.

Execution context

Every command resolves one workspace context:

  1. --workspace <id-or-handle> selects a workspace for one command.
  2. EPISMO_WORKSPACE selects one for a shell or job.
  3. A workspace-scoped EPISMO_TOKEN limits access to its embedded workspace.
  4. Otherwise, epismo workspace use <workspace> selects the saved default; without one, commands use personal space.
epismo workspace list
epismo workspace use acme
epismo -w acme playbook list --output table
epismo workspace current
epismo workspace clear

For CI, create a workspace-scoped token, store it in a secret manager, inject it as EPISMO_TOKEN, and run epismo whoami at job startup to verify identity and context.

Playbook commands search, author, publish, and share guidance. Case commands start real work, assign responsibility, and record outcomes for handoff and review. Scripting covers JSON input, pagination, and safe retries for automation. Administration covers workspaces, teams, members, credits, and scoped tokens for CI. The reference lists the complete command hierarchy.

In this section