今すぐ始める

CLI reference

Install、authentication、workspace selection、pack/track 操作、CI 利用までをまとめた CLI ガイドです。

epismo CLI は、Epismo を最初に試すときにも、日常運用や CI で使うときにも中心になる interface です。CLI は HTTP API と近い payload を受け取るため、CLI で動く JSON を確認してから API integration に移ると失敗しにくくなります。

Setup and authentication

まず Setup で CLI の install と JSON input/output を確認します。

次に Authentication で sign-in、sign-out、local credential storage を確認します。

Workspace selection

CLI command は常に 1 つの execution context で実行されます。

  1. EPISMO_TOKEN がある場合、token に埋め込まれた workspace が使われます。
  2. それ以外では epismo workspace use <workspace-id> で保存した default workspace が使われます。
  3. Workspace が未選択なら personal space が使われます。
epismo workspace list
epismo workspace current
epismo workspace use <workspace-id>
epismo workspace clear

workspace clear は、再び personal space で作業したいときに使います。

Create and read packs

Pack は再利用する知識や手順です。workflow は steps、context は blocks を使います。

epismo pack create --type context --title "Repo map" --personal \
  --blocks '[{"title":"Services","content":"api, mcp, cli"}]'
epismo pack create --type workflow --title "Release review" --projects <project-id> \
  --steps '[{"title":"Summarize changes","content":"List merged PRs."},{"title":"Check migrations","content":"Confirm database impact."}]'

Default の pack get は outline を返します。すべての nested content が必要なときは --full、一部だけ必要なときは --block-id または --step-id を使います。

epismo pack get <pack-id>
epismo pack get <pack-id> --full
epismo pack get @repo-map --block-id b001,b002
epismo pack get @handle/repo-map
epismo pack get https://epismo.ai/share/<token>

Update packs

Pack update は PATCH semantics です。省略した field は維持されます。Nested content は operation array で更新します。

epismo pack update @repo-map --blocks '[{"op":"add","title":"Local setup","content":"npm install"}]'
epismo pack update @repo-map --blocks '[{"op":"update","id":"b001","content":"Updated text"}]'
epismo pack update @repo-map --blocks '[{"op":"remove","id":"b002"}]'

Workflow step も同じように steps の operation array で更新できます。

Create and search tracks

Track は実行中の作業です。

epismo track create --type task --title "Fix API docs" --personal \
  --task '{"status":"todo","dueDate":"2026-06-05"}'
 
epismo track create --type goal --title "Ship docs v1" --projects <project-id> \
  --goal '{"status":"on_track","progress":40}'

Task status は backlog, todo, in_progress, done です。Goal status は not_started, on_track, at_risk, postponed, completed です。

epismo track search --type task --personal --filter '{"status":["todo","in_progress"]}'
epismo track search --type goal --projects <project-id> --filter '{"progressMin":50}'

複数 task をまとめて作る場合は track apply を使います。

epismo track apply --personal --input '{
  "updateDrafts": [
    {"id":"t001","title":"Task A","task":{"status":"todo"}},
    {"id":"t002","title":"Task B","task":{"status":"todo","dependsOn":["t001"]}}
  ]
}'

t001 や t002 のような非 UUID の ID は新規作成として扱われ、同じ request 内で参照できます。

Aliases

Alias は pack への読みやすい参照です。

epismo alias upsert @deploy-review --type workflow --id <pack-id>
epismo alias get @deploy-review
epismo alias get @handle/deploy-review
epismo alias list --type workflow
epismo alias delete @deploy-review

Alias name は保存時に先頭の @ が取り除かれます。/ と control character は使えません。Owner prefix は読み取り時だけ使います。

Workspace and project management

Workspace は組織境界、project は private sharing container です。

epismo workspace create --name "Team" --plan basic
epismo workspace update <workspace-id> --name "New name"
epismo workspace checkout <workspace-id>
 
epismo workspace member list
epismo workspace member upsert <user-id> --role admin
epismo workspace member delete <user-id>
epismo project list
epismo project create --name "Website" --description "Docs and marketing site"
epismo project update <project-id> --name "Website docs"
epismo project member add <user-id> --project-id <project-id>

Agents and credits

Installed agents は task assignee や workflow step assignee に使います。

epismo agent list
epismo agent add --agent-ids agent_a,agent_b
epismo agent remove --agent-ids '["agent_a","agent_b"]'

Credit balance と checkout は次の command で扱います。

epismo credit balance
epismo credit checkout --allocations '[{"userId":"<user-id>","quantity":500}]'

Credit は agent usage、pack search、track search、pack read で消費されます。CLI では epismo pack search、epismo track search、outline/selected block/step/full mode の epismo pack get が該当します。大きな pack を扱うときは、まず outline を確認してから必要な block/step だけを取得してください。

CI/CD tokens

CI では OTP login ではなく CLI token を使います。

epismo token create --workspace-id <workspace-id>

発行した token を CI secret に保存し、job では EPISMO_TOKEN として渡します。

export EPISMO_TOKEN="$EPISMO_TOKEN"
epismo pack search --type context --query "release"
epismo track apply --input @plan.json

EPISMO_TOKEN が設定されている場合、保存済み workspace default は無視されます。これにより CI の実行 context が安定します。

Command cheat sheet

すべての command を一覧で確認したい場合は All commands を参照してください。

このセクション内