Packs

Create, read, update, search, and alias packs from the terminal.

Use epismo pack for reusable workflow and context artifacts.

Create a context pack

epismo pack create --type context --title "Repo map" --personal \
  --blocks '[{"title":"Services","content":"api, mcp, cli"}]'

Create a workflow pack

epismo pack create --type workflow --title "Release review" --projects <project-id> \
  --steps '[{"title":"Summarize changes","content":"List merged PRs."}]'

Workflow step dueDate is relative to a future workflow run. Use "7" for seven days after the run starts. It is not YYYY-MM-DD.

Read packs

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

Default reads return outline data. Use --full only when the full nested content is needed.

Credits are consumed by pack search and pack reads. epismo pack get consumes credits in outline, selected block/step, and full modes. Read the outline first, then fetch only the nested content you need.

Update nested content

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

Omitting --blocks or --steps keeps nested content unchanged. Passing [] is a no-op. Removing all nested items requires one remove operation per item ID.

Aliases

epismo alias upsert @repo-map --type context --id <pack-id>
epismo alias get @repo-map
epismo alias list --type context