Files
coder/docs/coder-agents/chat-search-syntax.md
T
Ethan 9fa68ac013 feat: hold every steer message while one is under edit (#31748)
Whilst a steer message is under edit, every steer message now waits, not
just the one under edit and the ones behind it.

Say Next step holds A, B and C, and you edit B. Before this, A went to
the agent at the next model call whilst B and C waited. Now nothing goes
out until the edit ends, then A, B and C go in together. If the turn
ends whilst a steer message is under edit, the chat pauses, the same as
it already does for a queue message. `GetChatQueuedMessageHead` now
returns a steer message under edit first, so the paused check still
finds it when it isn't the first row.

Queue messages are unchanged: editing one holds it and the messages
behind it.

On the site, every other row shows "Waiting" whilst a steer message is
under edit, and Enter on an empty composer won't send the first held
message whilst it's waiting on an edit. The docs are updated to match.

The first version of this PR refused edits on steer messages instead,
following [Mathias's review of
#30074](https://github.com/coder/coder/pull/30074#pullrequestreview-5352986208).
Mathias has since suggested holding the whole steer lane, so the agent
never starts working on part of what you sent.

Part of CODAGT-1140
2026-11-09 15:55:18 +11:00

6.2 KiB

title
title
Conversation search syntax

The chat list endpoint accepts a q query parameter for filtering conversations. All filters use key:value syntax. Bare search terms are rejected. Use title: for title filtering or search: for full-text search.

Filters

Key Values Description
title substring Case-insensitive substring match. Quote multi-word values.
archived true, false Filter by archived state. Default: false.
has_unread true, false Conversations with unread assistant messages.
status waiting, running, error, requires_action, interrupting, paused Conversation state. Comma-separated or repeated values match any of them.
pr_status draft, open, merged, closed, none Linked pull request state. Comma-separated for OR. none matches conversations with no linked pull request.
diff_url URL Match by associated diff URL. Quote values containing colons.
pr positive integer Exact PR number match.
repo substring Case-insensitive substring match against git remote origin or URL. Quote values containing colons.
pr_title substring Case-insensitive PR title substring match. Quote multi-word values.
source created_by_me, shared_with_me Ownership scope. Default: created_by_me. Pass both values comma-separated to return owned and shared conversations.
search text Full-text search across chat titles, PR titles, PR numbers, and message content. Quote multi-word values.

Multiple filters in one query combine with AND logic. search: cannot be combined with title:, pr_title:, or pr:.

search: uses token-based PostgreSQL full-text search:

  • Case-insensitive whole-word matching with AND semantics. Quoted phrases, OR, and - negation follow websearch_to_tsquery rules.
  • Message content matches English word stems (refactor matches refactoring) and ignores English stopwords. Titles and PR titles do not stem.
  • No fuzzy, semantic, or word-prefix matching.
  • Whole-number values also match PR numbers by prefix: 302 matches PR 30281.
  • A value with no searchable words (punctuation only) returns an empty list. An empty value returns HTTP 400.
  • Results use the standard chat list ordering (pinned first, then most recently updated) and pagination, without match snippets.
  • Message content becomes searchable shortly after it is written (background indexing, usually within 10 minutes). Titles and PR titles are searchable immediately.

Examples

# Title substring (case-insensitive)
?q=title:deploy

# Multi-word title (URL-encode the space or use +)
?q=title:my+project

# Unread conversations
?q=has_unread:true

# Conversations that need you, or that failed
?q=status:requires_action,error

# Conversations with a turn in progress
?q=status:running

# Conversations with open or draft PRs
?q=pr_status:open,draft

# Conversations with no pull request, or an open one
?q=pr_status:none,open

# Filter by diff URL (quote values containing colons)
?q=diff_url:"https://github.com/coder/coder/pull/123"

# Combine filters
?q=title:refactor+has_unread:true+pr_status:merged

# Conversations linked to PR #42
?q=pr:42

# Conversations for a specific repository
?q=repo:coder/coder

# Conversations with a specific PR title
?q=pr_title:"fix auth bug"

# Conversations shared with you, plus your own
?q=source:created_by_me,shared_with_me

# Full-text search across titles, PR titles, and messages
?q=search:"kubernetes restart"

# Combine full-text search with other filters
?q=search:refactor+pr_status:open

Notes

  • status:waiting is an idle conversation, status:running is a turn in progress, and status:interrupting is a turn being stopped.
  • status:requires_action means the agent needs you before it can continue, and status:error means the turn failed.
  • status:paused means a turn finished while the next queued message, or any message under Next step, was being edited. The agent does not continue until the edit ends.
  • title:, repo:, and pr_title: use ILIKE matching. % and _ act as wildcards.
  • pr_status:draft means the PR is open and marked as a draft. pr_status:open means the PR is open and not a draft.
  • pr_status:none matches conversations with no pull request, including those whose linked PR was cleared.
  • Conversations without a linked diff status are excluded when pr, repo, pr_title, or any pr_status value other than none is set. The repo: filter also matches chats tracking a branch with no PR.
  • Unrecognized keys, bare terms, or combining search: with title:, pr_title:, or pr: return HTTP 400 with a validation error.