Manage agents.
An agent is a service account you own — a non-human principal that authenticates with an API key. Agents are global (owned by you, names unique per user), independent of any space. Create an agent, add it to the spaces it should work in, then mint it an API key with me apikey.
These commands authenticate with your session (me login). Lifecycle commands (create/list/rename/delete) are global; add and groups operate on the active space.
- me agent list -- list your agents
- me agent create -- create an agent
- me agent rename -- rename an agent
- me agent delete -- delete an agent
- me agent add -- add an agent to the active space
- me agent groups -- list an agent's groups in the space
List your agents. Alias: me agent ls.
me agent list
Create an agent (a global service account you own).
me agent create <name>
| Argument | Required | Description |
|---|---|---|
name |
yes | Agent name (unique among your agents). |
Rename an agent.
me agent rename <agent> <new-name>
| Argument | Required | Description |
|---|---|---|
agent |
yes | Agent id or name. |
new-name |
yes | New name. |
Delete an agent. Its API keys are deleted with it. Alias: me agent rm.
me agent delete <agent>
| Argument | Required | Description |
|---|---|---|
agent |
yes | Agent id or name. |
Add one of your agents to the active space's roster. It joins with owner over its own home — nested under yours (home.<your-id>.<agent-id>), so you can see what it stores under ~. Grant it shared access (e.g. on share) with me access.
me agent add <agent>
| Argument | Required | Description |
|---|---|---|
agent |
yes | Agent id or name. |
List the groups an agent belongs to in the active space.
me agent groups <agent>
| Argument | Required | Description |
|---|---|---|
agent |
yes | Agent id or name. |
me apikey-- mint, list, and revoke an agent's API keys.me access-- grant the agent access to tree paths.- MCP Integration -- run an agent against a space over MCP.