Docs/CLI reference

CLI reference

tama sessions

Reports every recorded live agent session and the hook state projected into its session-control record.

Reports every recorded live agent session and the hook state projected into its session-control record.

#Invocation

tama sessions [--json] [--home <path>]

--home selects the home containing Library/Application Support/Tama/session-control; otherwise Tama uses HOME. --json prints the full session array.

#Output and state

Text mode prints agent id, the first 12 characters of session id, and either loaded/registered hook counts or the effective allowlist when hooks are globally disabled. JSON includes status, working directory, counts, enabled and disabled ids, and update time. The command only reads session records.

#Refusals and failures

A missing or unreadable control directory produces an empty result and exit 0. An invalid individual JSON file is retained as a row with parseError: true; an unreadable file becomes readError: true. These records are surfaced rather than causing a command-wide refusal.

Return to the complete CLI command tree.