Manage spaces.
A space is an isolated collection of memories with its own roster, groups, and access grants. It is identified by an immutable 12-character slug (also the X-Me-Space header value and the me_<slug> database schema) and a renamable display name. Your active space is the one carried on every memory command; set it with me space use (or me login <space>).
These commands authenticate with your session (humans only — me login). Invitations operate on the active space.
- me space list -- list the spaces you belong to
- me space use -- set the active space
- me space create -- create a space
- me space rename -- rename a space
- me space delete -- delete a space
- me space invite -- invite a user (and manage invitations)
List the spaces you belong to. The active space is marked. Alias: me space ls.
me space list
Set the active space (the X-Me-Space context used by other commands). Stored in ~/.config/me/config.yaml per server.
me space use [space]
| Argument | Required | Description |
|---|---|---|
space |
no | Space slug or name. Prompts interactively if omitted. |
Create a new space and make it active. As the creator you become a space admin and receive owner@home and owner@share (not owner@root).
me space create <name>
| Argument | Required | Description |
|---|---|---|
name |
yes | Display name for the space. |
Rename a space's display name. The slug is immutable (it's the schema name and routing key), so this changes only the label.
me space rename <space> <new-name>
| Argument | Required | Description |
|---|---|---|
space |
yes | Space slug or name. |
new-name |
yes | New display name. |
Permanently delete a space and all its data — memories, grants, groups, invitations. Irreversible. Alias: me space rm.
me space delete <space> [--force]
| Argument | Required | Description |
|---|---|---|
space |
yes | Space slug or name. |
| Option | Description |
|---|---|
--force |
Skip the confirmation prompt. |
Invite a user to the active space by email. If the email already belongs to a registered user, they're added immediately; otherwise a pending invitation is recorded and redeemed at their next verified login. Admin only.
me space invite <email> [--admin] [--share <level>]
| Argument | Required | Description |
|---|---|---|
email |
yes | The invitee's email address. |
| Option | Description |
|---|---|
--admin |
Make the user a space admin (structural authority). |
--share <level> |
Access to grant at the shared root: none, read, write, or owner (default: read). |
A joining user always receives owner@home (their private root); --share controls their access to share.
List pending invitations for the active space. Alias: me space invite ls.
me space invite list
Revoke a pending invitation by email.
me space invite revoke <email>
| Argument | Required | Description |
|---|---|---|
email |
yes | The invited email to revoke. |
- Access Control -- principals, the two axes of authority, and tree-access grants.
me access-- grant read/write/owner access on tree paths.me group-- bundle members for shared grants.me agent-- add your agents to a space.