Kosmo agents
Run one agent or several, keep them apart, pin the ones you return to, and share one with your co-authors.
Kosmo is not a single chat window. Each conversation is an agent: it has a name, a tab, a status, and work it keeps doing whether or not you are looking at it.
Start an agent
Press Cmd+Shift+A (Windows: Ctrl+Shift+A), or click Kosmo in the sidebar, or use New agent to start another alongside the ones already running.
Every agent gets a name as soon as it starts: a persona and a topic, like Vega · Ablation table. The persona is what makes it findable in a list of three; the topic is what it is doing. Names are unique within a project, and you can rename any of them.
Several at once
Each agent gets its own tab and keeps working in the background. The sidebar lists them all with live status:
| Status | Meaning |
|---|---|
| Working | The agent is running its turn |
| Waiting for you | It asked a question, wants a plan approved, or needs permission for a command |
| Idle | It finished and is waiting for your next message |
Closing an agent's tab does not stop it. It keeps working and stays in the sidebar; click it to open it again. Moving one into another panel does not interrupt it either, and it keeps its transcript and its scroll position.
Agents on the same project know about each other. Each one sees what the others are working on and which files they have open, so two of them stop overwriting each other's work. When two agents have edited the same file, the diff shows which one wrote each change.
Hover an agent in the sidebar to see its current task and the files it has open.
Pin what you come back to
Everything is for this session unless you pin it. A pinned agent survives a restart: reopen the project and it is waiting in the sidebar with its conversation intact. Closing the project ends active local work rather than leaving a hidden process running. Closing the project ends active local work rather than leaving a hidden process running.
The floating assistant
Send an agent to the floating assistant to keep it on top of whatever you are reading, and send it back to a panel tab when you want the room. It keeps its tool calls and its history either way, and stays listed in the sidebar while it is over there.
Note: An agent has to be idle to move. Moving one mid-turn would kill the turn, so stop it first.
Share an agent with the project
On a cloud-synced project you can share an agent with everyone on it. They can read the whole conversation and send to it, one person at a time, so nobody talks over anyone.
A few things follow from that:
- Sharing pins the agent, and un-pinning stops the sharing.
- A shared agent shows who shared it. Only that person or the project's owner can take it off the project.
- Collaborators' turns run in the cloud. That means no terminal and no access to your local files, and the share menu says so before you share.
Teammate agents
An agent can send in teammate agents of its own for work that splits cleanly, like reading six papers at once. They appear in the timeline as they run and report back into the conversation. You do not manage them; the agent that sent them does.