grithdocs

grith supervisor

List active supervised sessions, inspect one in detail, or terminate it.

grith supervisor [list]
grith supervisor status <SESSION_ID>
grith supervisor kill <SESSION_ID>

The read side of grith exec. Session ids are UUIDs; list is the default when no subcommand is given.

terminal
$ grith supervisor
No active supervisor sessions.
Capacity: 0/2 sessions

ℹ️That capacity number is the licence cap

The ceiling is the lower of the licence cap and supervisor.max_concurrent_sessions. Community licences cap at 2 and the config ships at 4, so a stock Community install reports 0/2. Paid licences cap at 64, at which point the config value is the binding limit and the same install would report 0/4.

status

Prints the session id, tool, root pid, uptime, intercepted / allowed / queued / denied counts, how many events noise reduction filtered, containment state, and how many processes are in the session's tree.

terminal
$ grith supervisor status 00000000-0000-0000-0000-000000000000
Session not found: 00000000-0000-0000-0000-000000000000
Use `grith exec list` to see active sessions.

kill

Sends SIGTERM to the session's root pid and prints Terminated session <id8> (tool: <t>, pid: <p>). The supervised tool gets a chance to exit cleanly; grith detaches either way.

supervisor and exec list show the same sessions

grith exec list reads the same daemon registry with a slightly different row format and a capacity line counting live rows rather than the licence cap. Use whichever is to hand. The difference that matters: exec refuses outright when the daemon is unreachable, whereas supervisor falls back to an in-process daemon and warns.

See also

Last updated: 2026-08-24Edit this page on GitHub →