CLI Reference

Agent transcript log parsing and monitoring

Usage: aglogs [command]

Available Commands: completion Generate the autocompletion script for the specified shell help Help about any command list List available session transcripts query Query messages from a transcript read Read logs for a specific job, session, or log file tail Tail and parse messages from a specific transcript version Print the version information for this binary

Flags: -c, —config string Path to grove.yml config file -h, —help help for aglogs —json Output in JSON format -v, —verbose Enable verbose logging

Use “aglogs [command] —help” for more information about a command.

List available session transcripts, optionally filtered by project name

Usage: aglogs list [flags]

Flags: -h, —help help for list —json Output in JSON format -p, —project string Filter sessions by project, worktree, plan, or job name (case-insensitive substring match)

Global Flags: -c, —config string Path to grove.yml config file -v, —verbose Enable verbose logging

Query messages from a transcript

Usage: aglogs query <session_id> [flags]

Flags: -h, —help help for query —json Output in JSON format —role string Filter by message role (user, assistant)

Global Flags: -c, —config string Path to grove.yml config file -v, —verbose Enable verbose logging

Reads logs for a job execution. <spec> can be a plan/job, a session ID, or a direct path to a job or log file.

Usage: aglogs read <spec> [flags]

Flags: —detail string Set detail level for output (‘summary’ or ‘full’). Overrides config. -h, —help help for read —json Output in JSON format with additional metadata

Global Flags: -c, —config string Path to grove.yml config file -v, —verbose Enable verbose logging

Tail and parse messages from a specific transcript

Usage: aglogs tail <session_id> [flags]

Flags: -h, —help help for tail

Global Flags: -c, —config string Path to grove.yml config file —json Output in JSON format -v, —verbose Enable verbose logging

Print the version information for this binary

Usage: aglogs version [flags]

Flags: -h, —help help for version —json Output version information in JSON format

Global Flags: -c, —config string Path to grove.yml config file -v, —verbose Enable verbose logging