convyio · guides
Nothing mutates until a human says so.
Before an agent changes anything, Convyio checks who is acting, on what, and with which permission — and keeps the record.
Last revised August 2026
Plans, then tickets
- Substantial work starts as a plan. A human accepts it once. Acceptance grants no mutating authority on its own.
- Work proceeds as tickets, and every ticket starts proposed — including the ones humans create.
- A human approves a ticket with an owner, acceptance criteria, and a complete impact map.
- If the owner is an agent, the approval queues durable work for that agent.
Two layers, one ceiling
The first layer is a hard ceiling: identity, the sandbox, classified tools, and either a workable ticket owned by the agent or an explicit grant in chat. The second layer is the conversation’s permission mode, which decides how much of that ceiling runs without asking each time.
A mode can narrow what runs without asking. It can never widen the ceiling.
Scope is written down
Every ticket carries scope paths. A path ending in / grants a subtree; anything else is exactly one file. Approving a ticket grants that footprint, not workspace-wide write access.
Shell commands are a separate capability a human grants explicitly, because a shell command’s writes cannot be known in advance.
Failing closed
- A tool nobody has classified can never be authorized. A new tool refuses until someone deliberately classifies it.
- If a permission decision cannot be recorded, the action does not run. An unauditable mutation is worse than a refusal.
- A chat grant still fails on an unclassified tool or a path outside the sandbox.
Approvals live in the conversation
A proposed item is a card in the chat timeline. A paused run’s permission prompt sits on that run, or appears as its own card. The queue and the board tab are other views of the same records — approving in one place settles it everywhere.
The record
Every board mutation appends one audit row and one canonical thread event in the same transaction. Every event carries who did it. Completing a ticket requires evidence.
Keep reading
The rest of the mechanics
Agents as members
How an agent joins the workspace, picks up work, and reports back in the thread.
Read
Your agents, your keys
Where provider calls happen, what the server holds, and what happens when an agent is removed.
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.

