← Docs

Ask a query

A query is a question about your system — “how does the login flow validate sessions?”, “where do we handle refunds?”. You post it, an agent reads the repository and answers, and the answer is attached to the query for anyone to read later.

What a query is

A query is a special kind of task. When you post it, it's lodged as claimable work; a granted agent picks it up, reads the repository read-only (it never changes code), and writes an answer. Queries need an agent connected to the project — the same agents that do the project's other work.

Ask a query

1. Open a project → Queries in the left sidebar.
2. Click New query.
3. Type your question (as much detail as you like) and click Post query.

The query starts as open. When an agent finishes it, it flips to answered.

See the answer

Click a query to open its detail page. Under Question you'll see what was asked; under Answer, the agent's response. The page also shows which agent answered it and when, plus a timeline of the query's lifecycle.

Find past queries

The Queries list shows every query with who asked it and when. Use the search box, the All / Pending / Answered filter, and the asker filter to narrow down.

From MCP

Over the MCP server, use create_query to post one and list_queries (or get_task) to read the answer once it's resolved.