Skip to content

Command and filter syntax

Command field

Type into the command field in the toolbar (Alt Q) and press Enter. Help → Command Syntax and the command help show this list in the app.

Command Effect
?text select sessions whose URL contains text
>10k, <5k select by response size (k, m, g suffixes)
=404, =POST select by status code or method
@host select by host
select type select by content type, e.g. select image
find expr select sessions matching a filter expression
filter expr hide sessions not matching expr; filter alone removes it
keeponly type remove sessions whose content type does not match
cls, clear remove all sessions
tail 100 keep the most recent 100 sessions
bpu [text] break before requests (URL contains text); without text: off
bpafter [text] break after responses (URL contains text); without text: off
bps 500 break on a response status; bps alone: off
bpv POST, bpm POST break on a request method; alone: off
bpllm *, bpllm model=claude tool=mcp__jira__* tokens=50k break before LLM requests (any, or matching all conditions); alone: off
g, go resume all paused sessions
dump save all sessions as .saz
start, stop start or stop capturing
help show the syntax

Filter expressions

Filter expressions are used by filter and find in the command field and by Filters → Advanced expression.

host ~= "*.company.de" and method == POST and status >= 400
status == 4xx
size > 10k
time > 1s
not kind == tunnel

Fields

Field Aliases Meaning
host host
url full URL
path path and query
method verb HTTP method
status result, code response status; 4xx style values allowed
type ctype, content-type, mime response content type
process proc client process
size body, respsize response body size (k, m, g)
reqsize request body size
time duration, ms duration (200, 200ms, 1.5s, 2m)
comment comments comment
protocol proto protocol
color mark, marked mark colour (red, blue, …; '' for none)
kind session kind, e.g. tunnel
client clientip client address
custom the Custom column
id # session number
conn connection client connection id (sessions of one keep-alive or HTTP/2 connection)
trace correlation trace or correlation id of the request
session sessioncookie session cookie as NAME #hash
via reverse how the request came in: a reverse proxy entry, SOCKS5 or transparent
certdays cert days until the server's certificate expires (0: expired or expires within a day); e.g. certdays < 30
llm model LLM API call: provider/model, e.g. llm ~ claude
tokens tokens of an LLM call (input + output)
conv conversation the conversation (agent run) of an LLM call, e.g. conv == 3fa2c01d9b
mcp an exchange with an MCP server: method and tool, e.g. mcp ~ "tools/call"
mcpserver the MCP server's name, e.g. mcpserver == jira
agent the AI agent or SDK of an LLM or MCP request, e.g. agent ~ "claude code"
tls tlsversion TLS version towards the server (else the client), e.g. tls == TLSv1.2
ip remoteip, serverip the server's IP address, e.g. ip ~= "10.*"
http httpversion, version HTTP version of the request: HTTP/1.1, HTTP/2 …

Parts of a session's headers and bodies (slower on large captures: each session's details are read — in the list in the background, so recorded sessions appear a moment after the filter is set; sessions being recorded are tested at once):

Field Meaning
reqheader.NAME value of request header NAME (several are joined with ,; missing: empty), e.g. reqheader.x-api-version == 2
resheader.NAME value of response header NAME, e.g. resheader.server ~ nginx
header.NAME the request header, else the response header
cookie.NAME cookie NAME the request sends, else one the response sets (name with its case)
reqbody, resbody the decoded request or response body (its first 256 KB as text), e.g. resbody ~ "quota exceeded"

reqheader.authorization == "" finds requests without that header.

Operators

Operator Meaning
==, != equal, not equal
~= wildcard match (*, ?)
~, !~ contains, does not contain
=~ regular expression
<, <=, >, >= numeric comparison
and / &&, or / ||, not / !, ( ) combine

A bare word matches sessions whose URL contains it (case-insensitive).

Mock Rules patterns

The match patterns and actions of Mock Rules are listed in Change and replay → Mock Rules.