Workspace CLI reference

Use this page to inspect every public atoi workspace command, its accepted flags, and one runnable example. Two meanings share the word. use, current, create, list, leave, and clear manage Workspaces, the account boundary you and your collaborators share. show, bind, status, and changes keep the CLI's older meaning, a Project's source.

#workspace use

Choose the saved Workspace for later CLI calls that accept Workspace scope

The choice is shared by every shell using the same ATOI_HOME, which defaults to ~/.atoi

Selecting another Workspace in one shell changes the default in the others

Pass --workspace <id> or --personal to override one call without changing the saved choice

For independent saved choices, use a different ATOI_HOME in each shell and configure each home separately

atoi workspace use personal saves Personal as the default

#Run workspace use

atoi workspace use wsp_2f7d --json

#workspace current

Say which Workspace the terminal is standing in.

#Run workspace current

atoi workspace current --json

#workspace create

Create a Workspace you own. It starts with its own thread and Projects.

#Run workspace create

atoi workspace create --name "Eval solo" --json

#workspace update

Rename a Workspace, change its description, or set or clear its mark: an emoji, one of the ten colors, or an icon on a color.

#Run workspace update

atoi workspace update <workspace-id> --emoji "🌐" --json

#workspace list

List the Workspaces you belong to, the personal one first.

#Run workspace list

atoi workspace list --json

#workspace leave

Leave a Workspace you are a member of, by its id or its slug. You lose access to its threads and projects. What you wrote stays. Only a new direct invitation or a new thread link from a member brings you back.

The Owner transfers ownership first, from the Workspace's Members settings. Personal is never left. If the terminal was standing in the Workspace you left, it steps back out to Personal.

#Run workspace leave

atoi workspace leave eval-solo --confirm --json

#workspace show

Read the source attached to a Project.

#Run workspace show

atoi workspace show prj_8k2v --json

{
  "tool": "atoi_workspace",
  "arguments": {
    "action": "show",
    "project_id": "prj_8k2v"
  }
}

#workspace bind

Attach a repository and branch to a Project.

#Run workspace bind

atoi workspace bind prj_8k2v --repo owner/repository --branch main --json

{
  "tool": "atoi_workspace",
  "arguments": {
    "action": "bind",
    "project_id": "prj_8k2v",
    "repo_url": "https://example.com/river/atlas-notes.git",
    "repo_branch": "main",
    "idempotency_key": "workspace_atlas_1"
  }
}

#workspace status

Check and report the Project's local source state.

#Run workspace status

atoi workspace status prj_8k2v --directory . --json

{
  "tool": "atoi_workspace",
  "arguments": {
    "action": "status",
    "project_id": "prj_8k2v"
  }
}

#workspace clear

Empty one Workspace without deleting it. Its thread, documents, automations, tasks, and open questions go. Settings, connections, plugins, skills, and memories stay.

A cleared Workspace does not come back. Confirm the id before you pass --confirm.

#Run workspace clear

atoi workspace clear wsp_3f8a --confirm --json

#workspace changes

Read a Project's latest or selected Task change set.

#Run workspace changes

atoi workspace changes prj_8k2v --task tsk_3m9q --json

{
  "tool": "atoi_workspace",
  "arguments": {
    "action": "changes",
    "project_id": "prj_8k2v",
    "task_id": "tsk_7m3q"
  }
}

Read Run work from the terminal for the rest of this group, or the CLI reference index for every command.