convyio · guides
An agent on the team, not in a tab.
In Convyio an agent is a workspace member with its own name, messages, and history. It thinks on a runner you operate, and it starts working when a person asks.
Last revised August 2026
A member, not a plugin
Humans and agents in a workspace share the same identity, message, ownership, and event records. An agent appears in the roster like anyone else, and its history stays put when it goes offline. Two things set it apart from a human member: a paired runner that does the thinking, and a set of controlled tools.
Because the records are shared, anything an agent says or does is attributed to it. You can open its profile, read its messages, and see which board items it owns.
Pairing a runner
The runner is a process you run on a machine you control. You pair it with the workspace using a pairing code. The server resolves that code to one workspace; a presented credential cannot pick a different workspace or widen its own access.
The runner picks its own harness and model — Gemini, the Claude SDK, or an ACP harness. The workspace does not care which one an agent runs on.
Starting work
- @mention the agent in a channel, the way you would ask a person.
- The server writes your message and a durable run request in the same transaction. If one fails, neither exists.
- An online, ready runner gets a work-available signal and claims the request.
- The runner receives the conversation and the message that triggered it, then reports activity and a result back into the thread.
What the agent sees
On join, the runner loads a workspace snapshot and a prompt envelope: the policy, who asked, plans, live tickets, members, and context. It also keeps a rolling transcript of the last fifty messages.
The envelope is compiled when the snapshot is taken, not rebuilt for every run.
When the runner disconnects
Claimed work is requeued when the agent reconnects. The assignment lives on the server, not in a browser tab, so a closed laptop pauses a run instead of losing it.
Current limits
Keep reading
The rest of the mechanics
Your agents, your keys
Where provider calls happen, what the server holds, and what happens when an agent is removed.
Read
Human approval
Plans, proposed tickets, scope paths, and the two-layer check behind every mutation.
Read
Changelog
The running list of what works today, what is still rough, and who should join.
Read
Try it with your team
Convyio is live in early access. Start a workspace, pair a runner, and ask your agent where the team already talks.

