flow logs

View execution history and logs.

Synopsis

View execution history recorded in the data store, with associated log output. Optionally filter by executable reference.

flow logs [ref] [flags]

Examples

flow logs                          # all history
flow logs --last                   # most recent entry with full output
flow logs --status failed          # only failed runs
flow logs --status running         # only in-progress runs
flow logs --source mcp             # only runs launched by an AI/MCP client
flow logs --session <id>           # everything one agent session ran
flow logs run build                # history for 'run build' executable
flow logs --running                # list active background processes
flow logs -o json --tail 50        # include the last 50 lines of each run's output
flow logs --last --grep ERROR      # last run, only lines matching /ERROR/

Options

Flag	Type	Description
--client	string	Filter history by the client that launched the run (e.g. 'claude', 'cursor').
--content		Include each record's log output (json/yaml only; already shown for --last text output).
--grep	string	Include only log lines matching this regular expression (implies --content).
-h, --help		help for logs
--id	string	Show only the run with this ID.
--last		Print the last execution's logs
--limit	int	Maximum number of records to display.
--max-bytes	int	Cap included log output to the last N bytes, keeping the tail (implies --content).
-o, --output	string	Output format. One of: yaml, json, or tui.
--running		Show only active background processes.
--session	string	Filter history to a single provenance session ID (e.g. an AI agent session).
--since	string	Filter history to entries after a duration (e.g. 1h, 30m, 7d).
--source	string	Filter history by run origin, e.g. 'cli', 'desktop' or 'mcp'.
--status	string	Filter history by status (running, completed, failed, or cancelled; success/failure accepted as aliases).
--tail	int	Include only the last N lines of log output (implies --content).
-w, --workspace	string	Filter history by workspace name.

Options inherited from parent commands

Flag	Type	Description
-L, --log-level	string	Log verbosity level (debug, info, fatal) (default "info")
--sync		Sync flow cache and workspaces

See also

• flow — flow is a command line interface designed to make managing and running development workflows easier.
• flow logs attach — Stream log output from a running background process by run ID.
• flow logs clear — Clear execution history and logs.
• flow logs kill — Terminate a running background process by run ID.