Skip to main content
Trinity
Updated Nov 17, 2026main@87e21ff
FAQ/Chat & Sessions

Chat & Sessions

Workspace conversations, chat tabs and Main, the composer, models, files, the rail, background work. Short, grounded answers with links to the full documentation.

42 questions

How do I start chatting with an agent?

Two places. The Workspace (/workspace, opened from the nav in its own browser tab) is the main one: click an agent in the sidebar and you land in the chat you were last in with it — its pinned Mainchat the first time — and the conversation keeps its memory from turn to turn. The Chattab on the agent's detail page is a quick surface for one-off questions: each message runs as a new agent session, with the last 20 messages included for context. Either way the agent must be running. See Workspace and Agent Chat.

What's the difference between the Workspace and the Chat tab?

Memory. A Workspace conversation resumes: every message reattaches to the same underlying session, so the agent keeps its working memory between turns. The Chattab on Agent Detail is stateless — each turn replays the visible transcript as plain text and the agent starts cold every time. They are separate surfaces with separate history; the Chat tab carries a Continue in Workspace →link when you want continuity. (The old Session-mode toggle has been retired in the Workspace's favour.) See Continuous Conversations.

What does the agent actually remember between turns in the Workspace?

It preserves the agent's full working memory: tool results (files it read, commands it ran), mid-skill state, and reasoning state — not just the text of the conversation. The stateless Chat tab only re-sends the visible message log as text, so the agent loses tool outputs and internal state between turns. Use the Workspace for long multi-turn reasoning or multi-step work; the Chat tab is fine for one-shot questions. See Continuous Conversations.

Does the agent remember me from one chat to the next?

Yes, through person memory, which is separate from a chat's working memory. The agent keeps notes about you and Trinity keeps a rolling summary of your conversations, and both are given to it on every turn that serves you, in any chat. On the agent's Info tab, What it remembers about you shows the notes and every change to them, with Undo. Where an admin has turned on retrieval memory, the agent also recalls facts from earlier runs that match what you ask. Your memory is never shown to anyone else the agent talks to. See Agent Memory.

Why doesn't my agent seem to remember anything between turns?

Most likely you're on the Chattab rather than the Workspace — the Chat tab is stateless by design. If you are in the Workspace, the other cause is the runtime: a Codex agent has no resume primitive, so its turns replay the visible history as text instead of carrying working memory forward. The conversation stays coherent either way; what's lost is the agent's tool results and mid-task state. See Continuous Conversations.

Why does a long conversation suddenly take much longer on one turn?

That's auto-compact. When the agent's internal history approaches roughly 85% of the model's context window, it summarizes that history mid-turn and continues — which adds a couple of minutes to that one turn and is entirely normal. Your visible message log is untouched. After several compacts in one conversation the summary loses fidelity and answers get vaguer; that's the point to start a fresh chat. See Continuous Conversations.

Is the context window always 200K tokens?

No — the denominator is model-specific. Trinity prefers the context window the runtime itself reports for the model that actually ran; when that's unavailable it falls back to a per-model catalog (for example, Gemini and 1M-context Claude models such as Sonnet 5 report a 1M window, Codex around 1.05M on the gpt-5.6 family and around 272K on older ones, and plain Claude models default to 200K as a safe floor). So the percentage-used bar rescales to whichever model ran, and the same percentage can mean very different absolute token counts on different agents. See Agent Runtimes.

What is the Main chat, and what does Reset do?

Every (you, agent) pair has one pinned Mainchat: it is always the first tab above the thread, it can't be renamed, and it's where the agent reaches you when nothing else names a chat — an agent-initiated message, a question it raises outside a conversation, or a scheduled brief. Reset, in the header on Main only, archives the current Main and starts the agent cold; there's no confirmation because nothing is lost — the archived chat stays in your list as an ordinary, still-resumable chat, and a line in the new Main names it. Reset is refused while a reply is in flight, and resetting a Main you have never used does nothing. See Workspace.

How do I start a new chat with an agent, and can I rename it?

New chat in the conversation header (or ⌘J / Ctrl+J) starts a fresh chat with the agent in front of you; with no agent in front of you, the hotkey opens the agent picker instead. A provisional tab appears at once and the chat itself is created when you send the first message. Trinity names it from that message (and takes a second pass if your opener was only a greeting); to rename it, click the pencil beside its title or edit it on the sidebar row — one line of up to 100 characters, Enter saves, Esc abandons, and a name you typed always stands. Only Main can't be renamed. A direct link /workspace?agent=<name>lands on that agent the way a click on its sidebar row does — its chat with an unread reply first, else the chat you last had open with it in this tab, else a draft, else a new chat — and ?new=1 forces a fresh one. See Workspace.

Will I lose what I was typing if I switch to another agent or chat?

No. Unsent text survives switching agents, chat tabs and rooms, and comes back exactly as you left it. Every chat or room holding unsent text is marked Draft in the sidebar and on its tab. Sending clears the draft, and Reset carries it onto the new Main. Drafts are kept in this browser only; signing out deletes them, while a session that times out keeps them. See Workspace.

What is "Suggested for you" in the Workspace?

A short list computed for you and the agent in front of you: questions it is waiting on you to answer, decisions past their review date, skills you haven't run, a nudge when you haven't talked to it in a while, and — for the agent's owner or an admin — schedules that keep failing, never ran, or won't run because autonomy is off. Each item shows the signal it came from. Accepting one never sends anything: it pre-fills the composer or opens the section or page it names. Dismiss hides an item until its state changes. It appears on the Info tab and below the hints on an empty chat, for platform users only. See Workspace.

How do I make the agent forget the conversation and start fresh?

Start a new chat (New chat or ⌘J / Ctrl+J): it has no memory of the previous one. If you're in the agent's Main, use Resetin the header instead — it archives the current Main and starts the agent cold, keeping the old conversation in your list as an ordinary chat. Reach for either when the agent is going in circles, when you're switching topic and don't want bleed-over, or when repeated auto-compaction has degraded its answers. On the Chat tab each message already runs as a new agent session, with only the last 20 messages sent along as context, so there is no working memory to clear. See Continuous Conversations.

What do / and @ do in the Workspace composer?

They open a typeahead. Type /at the start of a word for the agent's skills — picking one splices its starter prompt into the field without sending — and @to bring another agent in. ↓ then Enter (or Tab for the top row) inserts the pick, Esc dismisses the list, and Enter on its own always sends. Picking an @ agent from a 1:1 opens a room containing both agents and posts your message there; rooms are covered in the Collaboration FAQ, and / skills are not offered inside one. See Workspace.

Who can see my chat history?

Chat messages are saved to the platform database and survive container restarts and even agent deletion. You see only your own messages; platform admins can see all messages. Workspace conversations are strictly per-person — even the agent's owner cannot open someone else's conversations with the same agent. See Agent Chat.

Where can I see what a chat message cost?

Every assistant reply is recorded with its cost, token usage, and execution time, and each session tracks cumulative cost across the conversation. For a per-run breakdown, the agent's Taskstab lists each execution with its cost and a context-usage bar, plus a Total Cost rollup, and the Execution Detail page shows dedicated Cost and Context cards. The agent's Overview also shows today's spend with a 7-day trend. The Workspace deliberately shows no cost or model figures — its band, Info tab and Work tab speak in outcomes — so for the numbers go to the agent's Tasks tab or the Executions page. See Executions.

Can several chats run on the same agent at once?

Yes, up to the agent's parallel-capacity limit (max_parallel_tasks, default 3), which chat shares with scheduled and background tasks. When all slots are busy, additional chat requests queue (up to 3 waiting); beyond that the request is rejected with a 429 "too many requests" error. Owners can raise the limit in the agent's Settings tab under Parallel Capacity, up to the fleet ceiling set by an admin. See Agent Configuration.

Why am I told the conversation is already handling a message?

Turns on one conversation are serialized on purpose — two simultaneous resumes of the same session could corrupt its state. Send a second message while one is still running and it waits up to 30 seconds for the first to finish, then gets a busy response with a retry hint — it is not queued. Wait for the current turn to finish, or start a separate chat for the parallel line of work. See Continuous Conversations.

How can I tell what the agent is doing while it works in the Workspace?

Read the live card under your message. Besides the status and elapsed time, it carries one line naming the current step — Reading .../src/app.py, Running pytest -q, Searching for "pattern", Delegating to researcher, Writing a reply, or Thinkingbetween steps. A new line slides up over the old one, and the line clears when the run ends. When you send, the chat scrolls down to the card unless you had scrolled up. Platform users see the same line on the Work tab's cards and on a room's cards, fed by the agent's heartbeat, and a heartbeat line older than 30 seconds is dropped rather than shown as current. See Workspace.

How do I stop a turn that's stuck or running too long?

In the Workspace and on the Chat tab, Send becomes Stop while a turn runs: click it, or press Esc with nothing else open, and the in-flight turn ends as cancelled (not failed) with your words put back in the composer, in front of anything you typed while waiting. The live card under your message in the Workspace carries the same Stop. In a room, a platform user gets a Stopon each working agent's card — see the Collaboration FAQ. Outside chat, the agent's Tasks tab and the Execution Detail page offer Stop execution for any running execution; if the work is still queued, cancelling removes it from the queue without touching the container. See Agent Chat and Executions.

Why did my message fail, and why isn't there always a Retry button?

A failed send tells you the real reason — the agent is busy, the turn timed out, the message was too large, there were too many messages, or the agent hit its usage limit — rather than a bare failure. Retryis offered only when nothing reached the agent: a turn the agent already ran is not silently sent and billed twice, so in that case ask again in your own words. An agent that is stopped or unreachable is labelled above the field before you type; the message still sends and the server's refusal is the answer. See Workspace.

Why does a chat turn show as failed when the agent had already written part of an answer?

Because the run ended in an error, and Trinity records that as a failure rather than passing the partial text — or an error message such as API Error: 500— off as the agent's reply. The execution is marked failed with the real error, which you can read on the Execution Detail page, and the chat route answers with an error status instead of a normal reply. If the evidence shows the agent did finish the turn and only its final result event was lost, Trinity recovers the reply instead of failing it. See Chat API.

Will my chat pick up where a scheduled run left off?

No. A chat continues only its own session, never the most recent session on the agent, so a schedule or other background run that happened in between does not leak into your conversation. That holds on Claude Code and Gemini agents alike. To deliberately carry a finished run's context into a chat, open the execution and click Continue as Chat: the Chat tab opens with a banner naming the execution, and the agent has the full context of that run. The button appears once the run has finished and has a resumable session. See Agent Chat.

Do chat_with_agent calls share a conversation with my Workspace chats?

No — they are separate conversations. A sequential chat_with_agent call (and POST /api/agents/{name}/chat, which the trinityCLI also uses) continues the agent's own chat session, which every caller of that route shares. Your Workspace chats are yours alone, and the Chat tab replays its own transcript with no session at all. The agent's owner or an admin can wipe the shared session with DELETE /api/agents/{name}/chat/history; it also starts fresh after a model change. On an agent in the experimental pull-mode pilot, each caller gets their own /chat conversation instead. See Agent Chat and Chat API.

Where are my earlier conversations on the Chat tab?

In the session dropdown at the top left of the Chat tab: it lists previous chats with their date, message count and last message, and selecting one loads it. New Chatstarts an empty one. These conversations are stored in the platform database and survive container restarts, but remember the tab is stateless — reopening an old chat shows its messages and replays the last 20 of them as text on the next turn; the agent has no working memory of it. See Agent Chat.

Why does the Chat tab say "Agent Not Running"?

The Chat tab needs a running container, so for a stopped agent it shows Agent Not Running — Start the agent to begin chatting— in place of the input. Start the agent from its header and the input returns. The same applies to the chat API: POST /chat on a stopped agent answers 503. See Managing Agents.

Can the agent keep working on something in the background while I chat?

Yes. An agent can dispatch a task to itself in parallel ("self-execute"), tell you it's working on it in the background, and keep the chat responsive. When the background task finishes, the result can be injected into the chat as a collapsed "Background Task Result" card you click to expand. Note there's no cancellation control for self-tasks from within the chat yet. See Self-Execute.

What happens if I close my browser while the agent is still working?

The turn keeps running on the server — the backend persists both your message and the agent's reply, so nothing is lost. When you come back, the UI checks whether a turn is still in progress on that conversation and reattaches, waiting for the reply instead of showing a false failure. Very long turns may take a moment to reconcile after the tab wakes up. See Continuous Conversations.

Can I pick a different model for a chat?

Yes, on both surfaces, though the pickers differ. In the Workspace, platform users on a Claude-runtime agent get a dropdown beside Send: Agent's default (…)names what the agent would use, and the other three options are plain-language tiers — Most capable, Balanced — fast and smart, Fastest. That choice is remembered per agent on your account, and if the agent can't complete a turn on the model you chose the reply says so and the choice reverts to the default; a Workspace turn resolves your explicit choice → the model the owner set for the agent's public channels → the platform default. On the Chat tab, the Default model dropdown above the input lists Claude models by name (or type any model id) and is remembered in that browser. Either way it applies to your chat turns only — not the agent's default model, and not its schedules, which have their own per-schedule override. See Workspace and Agent Chat.

What are the Fable 5 and Sonnet 5 models?

Fable is the most capable tier — reach for it on the longest, hardest, most involved tasks where quality matters more than speed. Fable 5.1is the current one; Fable 5 is still offered and still supported, just no longer the latest in its tier. Sonnet 5 is the fast, smart everyday model, and it carries a 1M-token context window, so it holds far more of a long conversation or large codebase before compaction. Both appear by name in the Chat tab's model picker, in the agent's Model Selection setting, and in the per-schedule and per-loop overrides. The Workspace dropdown speaks in tiers instead: Balanced — fast and smart is Sonnet 5, Most capable is Opus 5.5, and Fastest is Haiku. See Agent Configuration.

Does chat render markdown, and can I attach files?

Replies render as markdown on both surfaces — headings, lists, tables and code blocks — sanitized before display. In the Workspace a code block is its own object with a language label and an always-visible Copy, and every reply carries Copy message plus Helpful / Not helpful thumbs. On the Chat tab, attach with the paperclip or by dropping onto the input: images (JPEG, PNG, GIF, WebP) reach the agent as vision content, while plain text, CSV, JSON and ZIP are written to /home/developer/uploads/inside the container (a ZIP is stored as-is, not extracted). Limits are 3 files per message, 5 MB each, 10 MB of images in total; PDF, tar, gzip, video and audio are refused. Workspace uploads work differently — see the next question. See Agent Chat.

How do I send files to my agent in the Workspace, and where do they end up?

Click the paperclip, drop files anywhere on the conversation (Drop files to send to …), or paste a copied image or file into the message field — up to 20 files per drop, 25 MB each, uploaded one after another with a progress chip apiece; a refused file names itself and the limit. Sent files land in the agent's inbox inside its workspace and appear under Files you sent in the rail's Files tab, alongside Files from {agent}for anything it shared back. Click a name to preview it (images, Markdown and text up to 256 KB; ← and → step through the previewable files) or Downloadto save it. The bin icon deletes a file you sent or removes a shared file from your list without touching the share; an agent's owner signed in as a platform user also gets Delete for everyone. See Workspace.

How do I remove an attachment before sending it?

Click the ×on the file's chip in the composer. A file still waiting to upload never uploads; one already uploaded is deleted from the agent's inbox again, and in a room from every participant's inbox. The × does nothing while a send is settling or while an @mentionis carrying your files into a room. A file that was sent with a message is removed from the rail's Files tab instead, with the bin icon. See Workspace.

How do I know a reply has arrived when I'm not looking at the chat?

Three ways. While anything is unread, the browser tab's title carries the count — (3) Trinity — Workspace— and the agent's row in the sidebar shows its own unread badge (questions the agent is waiting on you to answer are counted separately). Inside a chat, if you've scrolled up to re-read something, an arriving message doesn't pull you back down: a N new messages control appears, and sending, opening a chat or clicking it returns you to the bottom. Opening the chat clears the count. Rooms count too: a room's row shows how many agent messages arrived since you last read it. See Workspace.

How is the Workspace Inbox sorted?

The Action tab lists the asks waiting on you newest first. A Sort asksswitch in the list's head line changes it to Urgency: asks expiring within 24 hours first (soonest first), then by priority, then the oldest first. The switch is remembered for you in this browser, a link can carry it (?sort=urgency), and the rail's Asks tab always uses the newest-first order. Unread and Allare by recency and have no switch. Rows hold their place while you stay on a tab — a poll never re-sorts them under you, and changing the sort re-sorts once. See Workspace → The Inbox.

Can I switch the Workspace between light and dark mode?

Yes. The theme switch sits at the right end of every chat and room header, and it names what is on screen — Light, Dark, or System · dark / System · light when it follows your operating system (just an icon on a phone). Click it and pick Light, Dark or System. It is the same setting as the main app's theme control and is remembered in this browser, and switching keeps your place, draft and thread. External clients signed in with an email code get it too. See Workspace.

What are the tabs in the rail beside the conversation?

The rail is the right-hand column, collapsed to a strip of icons by default; its state is remembered across chats and reloads, and a dot on a tab means something happened since you last looked. In order: Infois the agent's context — suggestions for you, the agent's role when it has one, your chats with it, what it can do, its published reports, what it remembers about you, and the decisions you recorded with it; Canvasshows the agent's canvases — what a canvas is and who sees it is in the Advanced Features FAQ, and pinning, deleting, sharing and "this canvas" are answered below; Files holds files you sent and files the agent shared; Projects, on instances licensed for them, the agent's projects; Askslists the asks this agent is waiting on you for and is always there — with nothing waiting it offers Open the Inbox; Worklists the agent's executions from this chat and its history; Loops runs and watches loops on the agent (see the Scheduling FAQ). Work, Loops and Projects are for platform users only; an external client sees the others, with only the canvases the agent published to its roster. See Workspace.

What is the Steward card on a project page?

It names who stewards the project — the person or agent that owns its health and verifies finished tasks — with the project's health as a badge, and says what is behind that. For an agent steward it shows the last sweep (the last time the agent read its digest), its next scheduled run, and says No sweep recorded yet or No sweep scheduledplainly when that is the case, because Trinity does not run the steward: the agent moves the project only on its own schedule. For a person steward it lists what is waiting on them — tasks to verify, tasks blocked or waiting on a decision, tasks untouched for a week, a health update due — and offers Open I steward when that person is you. With nobody named, the creator stewards the project. See Workspace Projects.

Why did the agent update a canvas I wasn't looking at, or say which canvas it changed?

Because the canvas you have open on the rail's Canvastab is what "this" means in a chat turn. A request that names no canvas lands on the open one; if nothing is open it lands on the agent's default main; a canvas the agent names explicitly always wins. So add a column to thispatches the board you can see, and when you did not name one the agent tells you which canvas it changed. The open canvas travels with each message as context, not permission — the agent still reaches only the canvases it could already reach — and a canvas you deleted mid-conversation resolves to nothing, so the agent's next write does not recreate it. The Chat tab on Agent Detail carries no open canvas: name the canvas there. See Agent Canvas.

Can I pin or delete canvases, and who is allowed to?

Only the agent's owner (or an admin), signed in as a platform user; anyone else gets a read-only panel rather than buttons that would refuse. On the rail's Canvas tab, Manage shows each canvas with its age, a pin toggle and Delete, and a checkbox per row feeds Delete selectedwith one confirmation naming the count; the same controls live on the agent's Canvas tab on Agent Detail. Manage sits at the end of the canvas control row and opens its list below the row. A pinned canvas carries 📌 and comes first in the dropdown, rewriting it never un-pins it, and once an agent has more than six canvases a Search canvases… box filters by title or id. Pins and deletions are yours, never the agent's — it cannot pin its own canvas — and both are recorded in the audit log. The header states two facts and draws no conclusion from them — Updated 2h ago · agent last ran 40m ago— so read both timestamps before retiring anything. Each agent holds at most 100 canvases; the Agents FAQ covers the limit. See Workspace → The rail.

How do I share a canvas with someone outside Trinity, or save it as a PDF?

Share is on the agent's Canvas tab on Agent Detail (not on the Workspace rail) and produces a link with one of two scopes: People who already have access — the preselected default, where opening the link requires signing in and only people who can already see the agent see the canvas — or Anyone with the link, with no sign-in at all, which the dialog states plainly because it reaches further than the canvas did before. A shared link stays current: whoever opens it sees the canvas as the agent keeps updating it, with the last-updated time shown. Revoketurns a link off, and anyone holding it is told so rather than getting a broken page. Sharing is a person's decision only — owner or admin — and an agent cannot mint, list or revoke a link for itself. PDFis available from every canvas surface, including the rail: it uses your browser's own print-to-PDF, so the output matches what you see in one clean column, carries the canvas title, the agent and the date, and is always the light rendering even in dark mode. See Agent Canvas.

Why does the Workspace say earlier messages in this chat aren't shown?

The chat is very long and the thread is windowed: the Workspace renders the newest turns and says Earlier messages in this chat aren't shownwhen older ones were cut (a 30-minute voice call alone adds around 180 rows). Nothing is lost — the messages are still stored and the agent's own memory is unaffected; only how much the page draws is trimmed. If the length means the conversation has run its course, start a new chat or Reset Main. See Continuous Conversations.

Can I talk to my agent with voice?

Yes. In the Workspace, click the call button — the leftmost control in the composer — in the chat you want the call to belong to. The orb takes the conversation column with the agent's canvas beside it, speech runs both ways, and when the call ends the spoken turns sit in that chat as one collapsed Voice call · N minblock, so the agent's next typed turn knows what was said. The separate microphone control in the composer only dictates into the message field. Voice needs a Gemini API key on the platform and is for signed-in platform users only — the Chat tab is text only, and the Advanced Features FAQ covers what the agent can do during a call. See Voice Chat.