.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH console 1 "console "
.SH NAME
console \- Console message reading and monitoring
.SH SYNOPSIS
\fBconsole\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Read and monitor browser console messages (log, warn, error, info). Can capture existing messages or stream new messages in real time.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help (see a summary with \*(Aq\-h\*(Aq)
.SH SUBCOMMANDS
.TP
console\-read(1)
List console messages or get details of a specific message
.TP
console\-follow(1)
Stream console messages in real\-time (tail \-f style)
.TP
console\-help(1)
Print this message or the help of the given subcommand(s)
.SH EXTRA
EXAMPLES:
# Read recent console messages
agentchrome console read
# Show only error messages
agentchrome console read \-\-errors\-only
# Stream console messages in real time
agentchrome console follow
# Stream errors for 10 seconds
agentchrome console follow \-\-errors\-only \-\-timeout 10000
.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