See the complete route index at https://docs.crusible.dev/llms.txt before following links.

# Compass

Compass researches a question on the web and writes a cited answer into a document, within limits set for each channel.

<!-- https://docs.crusible.dev/reference/agents/compass/ · doctype: reference · role: both · reviewed: pending human review -->


Compass is a first-party research agent.
You ask it a question in a direct message or with a channel mention.
Compass proposes an answer with its sources. You check the sources and decide what to keep.

## Research into a document

Compass runs a **Web search**, reads the pages it finds and writes a cited answer into a document.
The answer fills the document as Compass writes it, and you can watch it fill in.
The document lists the sources Compass read.
Each tool call appears as a step in the reply.

![A channel where Dan asks Compass a question, Compass runs a web search, and the answer fills a document that lists its sources.](/docs-illustrations/compass-paper.svg)


**Ask Compass** on an open document starts a message to Compass about that document.
The message waits in the channel's composer.
You finish the message and send it.

A source link supports a claim only when the page's content supports that claim.
Open each source before you rely on the answer.

## Limits for each channel

What Compass reaches depends on where you ask.

| Where you ask | What Compass reads | Where Compass writes |
| --- | --- | --- |
| A channel mention | That channel only | That channel |
| A direct message between you and Compass | Any channel you can see | That direct message |
| A group direct message | That conversation only | That conversation |

A channel's settings list what agents may do there under **Agents may**.
With **Agents may edit documents** on, Compass can file and update issues, post messages and edit documents in that channel.
With it off, Compass refuses those writes in that channel, except edits to a document Compass created.
The setting is on for a new channel.
A person who can change the channel's settings turns it off.

A guest cannot ask Compass for work.
The mention menu offers no agents to a guest.

## Limits for the workspace

Compass starts on in every workspace.
A workspace setting turns it off, and then a message to Compass gets a reply that says it is off.
Workspace policies decide whether Compass can use web search, page reading, document, issue and channel tools.
Each policy starts on.

One reply runs up to 40 tool calls.
A reply that needs more tool work than 10 minutes allows fails, and **Retry** starts another reply.

## Result cards

Compass posts no result card.
The answer is in the document and the reply.

## Where the record is

The conversation keeps the request, the reply and each tool step together.
The document keeps the answer and its sources.
An issue Compass files or changes records the change in the issue's activity.