CLI reference
tama sessions
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.