Get Task Details

Get Task Details

Resolve task status path and metadata in one read-only command.

Invocation

/get-task-details [task-slug]

Command

python ~/pro/botfiles/codex/skills/_shared/task_status/scripts/get_task_details.py \
  --status-file "<optional-explicit-status-file>" \
  --task-dir "<optional-explicit-task-dir>" \
  --project-root "<project-root>" \
  --task-slug "<optional-slug>"

Output Contract

Default call with no task-slug:

• resolves the current task for this session
• checks the machine-local current-task pointer first
• if the pointer is missing or stale, falls back to the latest same-session task in the current project
• prints a clear no-match message instead of guessing from unrelated recent folders

Primary task output should include:

• Task folder
• Status file path
• Primary tracker kind
• Full primary tracker URL
• Tracker human ID
• Tracker title
• GitHub compatibility URL when present
• Machine
• Coding agent/session information
• Transcript path
• Zellij session
• Zellij link
• Recap block covering:
  • what the task is about
  • current status
  • next steps / whether user input is needed

If no task is found for the current session, print a clear message and suggest creating or adopting a tracked task.

Notes

• Read-only: this skill never edits files.
• If recent context already includes an exact task folder or status.md path, pass it directly.
• Preserve the full primary tracker URL in the output.
• The full shared contract lives in ~/pro/botfiles/docs/task-status-tracker-contract.md.
• Default mode is current-task-for-this-session; use task-slug only when you intentionally want cross-session lookup.
• Hermes-specific fallback: if env session IDs are missing but the session title is known, set HERMES_SESSION_TITLE or SESSION_TITLE before invoking get_task_details.py. The shared helper can then resolve the real Hermes session ID from ~/.hermes/state.db, which mirrors the session identity a human can inspect via /title.
• If a tracked task was previously synced under a placeholder/manual session ID, re-run sync_task_metadata.py with the real Hermes session ID so current-task pointer lookup and get-task-details align for future calls.