今すぐ始める

CLI リファレンス

インストール、認証、ワークスペースの選択、パック / トラックの操作、CI 利用までをまとめた CLI ガイドです。

epismo CLI は、Epismo を最初に試すときにも、日常運用や CI で使うときにも中心になるインターフェースです。CLI は HTTP API と近いペイロードを受け取るため、CLI で動く JSON を確認してから API 連携に移ると失敗しにくくなります。

セットアップと認証

まず セットアップ で CLI のインストールと JSON の入出力を確認します。

次に 認証 でサインイン、サインアウト、ローカルの認証情報の保存を確認します。

ワークスペースの選択

CLI のコマンドは常に1つの実行コンテキストで実行されます。

  1. EPISMO_TOKEN がある場合、トークンに埋め込まれたワークスペースが使われます。
  2. それ以外では epismo workspace use $WORKSPACE_ID で保存したデフォルトのワークスペースが使われます。
  3. ワークスペースが未選択なら個人スペースが使われます。
epismo workspace list
epismo workspace current
epismo workspace use $WORKSPACE_ID
epismo workspace clear

workspace clear は、再び個人スペースで作業したいときに使います。

パックの作成と読み取り

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

epismo pack create --type context --title "Team onboarding" --personal \
  --blocks '[{"title":"Where things live","content":"Docs in Notion, code in GitHub, designs in Figma."}]'
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."}]'

デフォルトの pack get はアウトラインを返します。すべてのネストした内容が必要なときは --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/$SHARE_TOKEN

パックの更新

パックの更新は PATCH 方式です。省略した項目は維持されます。ネストした内容は操作の配列で更新します。

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"}]'

ワークフロー の ステップも同じように steps の操作配列で更新できます。

トラックの作成と検索

トラックは実行中の作業です。

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}'

タスクのステータスは backlog, todo, in_progress, done です。ゴールのステータスは 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}'

複数のタスクをまとめて作る場合は track apply を使います。

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

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

エイリアス

エイリアスはパックへの読みやすい参照です。

epismo alias upsert @deploy-review --id $PACK_ID
epismo alias get @deploy-review
epismo alias get @handle/deploy-review
epismo alias list --type workflow
epismo alias delete @deploy-review

エイリアスの名前は保存時に先頭の @ が取り除かれます。/ と制御文字は使えません。所有者の prefix は読み取り時だけ使います。

ワークスペースとプロジェクトの管理

ワークスペースは組織の境界、プロジェクトは非公開の共有コンテナです。

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 upsert $USER_ID_1,$USER_ID_2 --role member
epismo workspace member delete $USER_ID
epismo workspace member delete $USER_ID_1,$USER_ID_2
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
epismo project member add $USER_ID_1,$USER_ID_2 --project-id $PROJECT_ID

エージェントとクレジット

インストール済みエージェントはタスクの担当者やワークフローステップの担当者に使います。

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

クレジットの残高とチェックアウトは次のコマンドで扱います。

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

CLI のクレジット消費は クレジット にコマンド別で記載しています。大きなパックを扱うときは、まずアウトラインを確認してから必要なブロック / ステップだけを取得してください。

コマンド早見表

すべてのコマンドを一覧で確認したい場合は 全コマンド一覧 を参照してください。

このセクション内