.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH read 1 "read "
.SH NAME
read \- List console messages or get details of a specific message
.SH SYNOPSIS
\fBread\fR [\fB\-\-type\fR] [\fB\-\-errors\-only\fR] [\fB\-\-limit\fR] [\fB\-\-page\fR] [\fB\-\-include\-preserved\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIMSG_ID\fR]
.SH DESCRIPTION
Read captured console messages from the current page. Without arguments, lists recent messages with their IDs, types, and text. Pass a message ID to get full details including stack trace and arguments. Filter by type or use \-\-errors\-only for error and assert messages only.
.SH OPTIONS
.TP
\fB\-\-type\fR \fI<TYPES>\fR
Filter by message type (comma\-separated: log,error,warn,info,debug,dir,table,trace,assert,count,timeEnd)
.TP
\fB\-\-errors\-only\fR
Show only error and assert messages (shorthand for \-\-type error,assert)
.TP
\fB\-\-limit\fR \fI<LIMIT>\fR [default: 50]
Maximum number of messages to return
.TP
\fB\-\-page\fR \fI<PAGE>\fR [default: 0]
Pagination page number (0\-based)
.TP
\fB\-\-include\-preserved\fR
Include messages from previous navigations
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help (see a summary with \*(Aq\-h\*(Aq)
.TP
[\fIMSG_ID\fR]
Message ID to get detailed information about a specific message
.SH EXTRA
EXAMPLES:
# List recent console messages
agentchrome console read
# Get details of a specific message
agentchrome console read 42
# Show only errors
agentchrome console read \-\-errors\-only
# Filter by type
agentchrome console read \-\-type warn,error \-\-limit 20
.SH CAPABILITIES
.PP
Console message reading and monitoring
.TP
.B console read
List console messages or get details of a specific message
.TP
.B msg_id
Message ID to get detailed information about a specific message
.TP
.B --type
Filter by message type (comma-separated: log,error,warn,info,debug,dir,table,trace,assert,count,timeEnd)
.TP
.B --errors-only
Show only error and assert messages (shorthand for --type error,assert)
.TP
.B --limit
Maximum number of messages to return
.TP
.B --page
Pagination page number (0-based)
.TP
.B --include-preserved
Include messages from previous navigations
.TP
.B console follow
Stream console messages in real-time (tail -f style)
.TP
.B --type
Filter by message type (comma-separated: log,error,warn,info,debug,dir,table,trace,assert,count,timeEnd)
.TP
.B --errors-only
Show only error and assert messages (shorthand for --type error,assert)
.TP
.B --timeout
Auto-exit after the specified number of milliseconds
.TP
.B --fail-on-error
Exit with code 1 if any error-level console message is observed during the window
.SH EXAMPLES
.PP
Examples:
.TP
.B \`agentchrome console read\`
Read recent console messages
.TP
.B \`agentchrome console read --errors-only\`
Show only error messages
.TP
.B \`agentchrome console follow\`
Stream console messages in real time
.TP
.B \`agentchrome console follow --errors-only --timeout 10000\`
Stream errors for 10 seconds
.TP
.B \`agentchrome console follow --timeout 10000 --fail-on-error\`
CI assertion: exit 1 if any console.error is seen within 10s