Chats
Use Chats and the composer to work with Agents — models, turns, forks, skills, and sharing.
A Chat is a conversation context inside a Space. In CLI/API terms it is a session.
Create and open Chats
- New Chat starts a clean thread in the current Space
- The sidebar lists recent Chats, often grouped by labels
- Cross-space recent Chats also appear in the sessions inbox
Use multiple Chats when goals diverge. Keep one Chat focused when continuity matters.
Anatomy of a Chat
| Piece | Role |
|---|---|
| Transcript | Messages, tool calls, streaming output |
| Turns | Discrete units of work you can navigate |
| Composer | Input, model, attachments, slash tools |
| Header / actions | Rename, share/access, related tools |
Composer
The composer is how you steer the Agent.
Send messages
Entersends- Force send is available when you need to bypass a local block
- Long instructions can be pasted or attached as files
Choose a model
Pick the model that matches the job. You can change models between turns when the UI allows it.
Attachments
Attach images or files when the Agent needs source material that is not already in the Space workspace.
Slash commands and skills
Type / to browse prompt templates and skills.
- Prompt templates insert structured instructions
- Skills often appear as
/skill:name - Skill availability depends on Space, user, platform, and mounted Mods
Mentions
Use @space mentions when the Agent should pull context from another Space you can access.
Mentions are for deliberate cross-space context, not every message.
Working with turns
Chats are turn-based:
- You send a prompt
- The Agent streams a response, often with tool calls
- The turn finalizes
- You continue, fork, or stop
Useful patterns:
- Ask for a plan before large edits
- Inspect file diffs / preview before the next instruction
- Start a fork when you want an alternate branch of the conversation
Follow-ups
Some queued follow-ups can be steered or cancelled. Use that when the Agent is mid-work and the next instruction should change.
Forking
Fork a Chat when you want to keep the current history but explore a different path.
Forks preserve lineage so you can compare approaches without overwriting the original thread.
Sharing and access
Chats can have access controls beyond the Space default.
Typical cases:
- Keep a Chat private inside a shared Space
- Allow broader read access for a specific thread
- Share a conversation without opening the whole workspace
Exact policy controls live on the Chat / session access surface and in Space settings.
Labels and organization
Label Chats so the sidebar stays scannable:
- By feature
- By status (
todo,blocked,shipped) - By collaborator or channel source
System labels may also appear for user/channel/source groupings.
Keyboard essentials
| Action | Shortcut |
|---|---|
| Search everywhere | ⌘K / Ctrl K |
| New chat | ⌘O / Ctrl O |
| Open help | ? |
| Focus composer | i (when not typing elsewhere) |
| Send | Enter |
See in-app help for the full shortcut list.
Practical tips
- One goal per Chat when possible
- Put durable project state in files, not only in Chat prose
- Save the Space when the workspace reaches a good milestone
- If the Agent is lost, restate the goal and point at concrete files