Tracks

Create, search, update, and bulk apply tasks and goals.

Use epismo track for active work.

Create a task

epismo track create --type task --title "Fix API docs" --personal \
  --task '{"status":"todo","dueDate":"2026-06-05"}'

Task statuses are backlog, todo, in_progress, and done. Dates use YYYY-MM-DD. On update, an empty string clears optional task date, status, parent, or goal linkage fields where supported.

Create a goal

epismo track create --type goal --title "Ship docs v1" --projects $PROJECT_ID \
  --goal '{"status":"on_track","progress":40}'

Goal statuses are not_started, on_track, at_risk, postponed, and completed.

Search tracks

epismo track search --type task --personal --filter '{"status":["todo","in_progress"]}'
epismo track search --type goal --projects $PROJECT_ID --filter '{"progressMin":50}'
epismo track search --type task --query "auth bug" --search-mode semantic

--search-mode selects the ranking mode: keyword (default) or semantic (keyword matching plus vector similarity). Omit it for keyword search.

Command	Cost
`epismo track search`	2 credits
`epismo track create`	1 credit
`epismo track update`	1 credit
`epismo track get`	1 credit
`epismo track review`	AI token usage
`epismo track apply`	1 credit
`epismo track delete`	1 credit

Use search results to narrow the target set, then call epismo track get <track-reference> only for records that need detail. A track reference is a task/goal UUID or a URL containing that UUID; tracks do not have aliases.

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

Non-UUID ids create new records and can be referenced by other upserts in the same request.

The server infers the track type from task or goal. Do not pass both on the same upsert. New tracks require title; UUID ids update existing records and keep omitted fields unchanged.

Review

epismo track review <track-reference>
epismo track review <track-reference> <another-track-reference> --instruction "Focus on cross-target patterns."

Generates a read-only review for one or more tasks/goals (accepts UUIDs or URLs). Passing multiple references lets the review compare related work and extract cross-target patterns.

Detailed reviews return Markdown content and stats, consuming credits based on AI token usage. Lightweight review stats returned from status updates are free of charge.

Reviews do not automatically write to logs or packs. To save the verdict or result to the track, append it explicitly:

epismo log create <track-reference> --kind review --content "$REVIEW_SUMMARY"

See Logs for appending, listing (one track or across every track), and deleting activity/comment logs.