Switch Workspace
switch_workspaceNarrow this session's memory to one project: name='' scopes recall, the wake bundle, self-notes and the default namespace for new facts to project::* (identity and conventions always ride along). Returns the narrowed bundle right away. name='' widens back to the whole account. Sticky for the session and across reconnects; bind_agent is unaffected. The same call ENTERS a workspace someone shared with this account: name='' (or their tenant id, or the granted prefix, as listed by list_workspaces) switches this connection into it; no second server, no header, no restart; it holds for the session. name='' leaves it for the session. HOME WORKSPACE: remember=true also makes it this account's home, so every new session starts inside it; switch_workspace(name='', forget=true) forgets the home. An account with no facts of its own and exactly one shared workspace starts inside that workspace automatically. list_workspaces and wake_status show the home and how this session entered (home, tool or header). When a person asks to work in someone else's shared memory, call this.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "switch_workspace"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Project slug (the <slug> in project:<slug>:*), the name of a granted workspace to enter (from list_workspaces), or '' to widen / leave. | |
| forget | No | With name='': also forget the home workspace, so new sessions start in your own account (the automatic home included). | |
| remember | No | With a granted workspace's name: also make it the home workspace, entered at the start of every new session. |