You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit ed1298a
Browse filesBrowse the repository at this point in the historyBrowse files
fix(workspace): confirm an existing link on this machine, and sync only to the verified one (review)
- `link --workspace`/`--create` for the workspace already linked records the link as confirmed here instead of returning with it still unconfirmed, so `workspace sync` accepts it
- `link`'s pre-check looks up the binding with the same captured credential as the list and the bind
- The same-name `--create` no-op runs before the workspace list is fetched, and `--allow-duplicate` skips it
- `workspace sync` passes the binding it verified to the memory sweep, which refuses an unconfirmed one, and refuses a link the service could not confirm just now (exit 1)
- `workspace unlink` of a project the service already detached still clears local workspace state
- `status` says when a "not linked" answer came from the recent-miss cache, when a link is not confirmed on this machine, and when memory could not be read (instead of "off")
- A bootstrap failure after the command already reported goes to stderr only; the directory in that message is stripped of control characters
- Docs: exit-code bullets merged; `status` details described as available when known
- Tests restore the prior `process.exitCode`
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_018fJ3X7pcGT4R9yzjsJnqsV
Copy file name to clipboardExpand all lines: docs/docs/usage/cli.md
+3-4Lines changed: 3 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,11 +54,10 @@ Workspace features are off unless `ALTIMATE_WORKSPACE=1` is set. With it:
54
54
55
55
-`altimate-code link` links the current project to a workspace (or creates one). The sidebar then names the workspace and shows how many memories are not yet synced and when skills last synced.
56
56
- From a shell, script or CI job, without the TUI:
57
-
-`altimate-code link --workspace <name|id>` links to an existing workspace (an id is matched before a name), and `altimate-code link --create [name]` creates one (named after the repo by default) and links to it. Neither prompts. If the project is already linked to a different workspace they refuse unless `--yes` is passed. Running `--create` again when the project is already linked to a workspace of that name changes nothing, so it is safe in a devcontainer's setup command; if another workspace already has that name it refuses and names its id, unless `--allow-duplicate` is passed.
58
-
-`altimate-code workspace status [--json]` shows the linked workspace, how many saved memories have not reached it, and when skills last synced.
57
+
-`altimate-code link --workspace <name|id>` links to an existing workspace (an id is matched before a name), and `altimate-code link --create [name]` creates one (named after the repo by default) and links to it. Neither prompts. If the project is already linked to a different workspace they refuse unless `--yes` is passed. Running `--create` again when the project is already linked to a workspace of that name creates nothing, so it is safe in a devcontainer's setup command; if another workspace already has that name it refuses and names its id, unless `--allow-duplicate` is passed. Linking to the workspace the project is already linked to confirms that link on this machine, which a fresh clone needs before `workspace sync` sends its memory.
58
+
-`altimate-code workspace status [--json]` shows the linked workspace and, when known, how many saved memories have not reached it and when skills last synced.
59
59
-`altimate-code workspace refresh` pulls the workspace's skills (memory is loaded by the next session started in the project); `altimate-code workspace sync` sends memory the workspace has not received; `altimate-code workspace unlink [--yes]` detaches the project (`--yes` is required without a terminal).
60
-
- Exit codes: `0` done, `1` failed (including when the workspace service could not be reached), `2` needs a different request (not signed in, or `--yes` missing), `3` the project is not linked. With `--json`, `ok` is `true` exactly when the exit code is `0`.
61
-
- These commands accept `--directory` and exit `0` on success, `1` on failure, `2` for a request to change (not signed in, or a re-link or unlink without `--yes`), and `3` when the project is not linked.
60
+
- These commands accept `--directory`. Exit codes: `0` done, `1` failed (including when the workspace service could not be reached), `2` a request to change (not signed in, a re-link or unlink without `--yes` and no terminal to confirm on, or a `sync` to a link not yet confirmed on this machine), `3` the project is not linked. With `--json`, `ok` is `true` exactly when the exit code is `0`.
62
61
-`/workspace` in the TUI opens a menu: **Refresh** pulls the workspace's skills and memory into this project, **Sync** re-sends local memory the workspace never received, **Open in browser** (when a web URL is available) shows the workspace on the web, **Switch workspace** relinks the project, **Unlink** detaches it. In a project that is not linked yet, it offers **Link to a workspace** instead.
63
62
-`altimate-code skill publish <name>` uploads a project skill to the linked workspace; see [Skills](../configure/skills.md#cli-commands).
64
63
- In an ordinary session the agent is told every turn which workspace the project is linked to — or that none is, or that the link could not be verified just now. In an extension-pinned session it is told the pinned workspace instead, and that it differs from the project's own link. Either way "which workspace am I in?" has an answer, and the agent is told not to confuse it with a Databricks workspace or an IDE workspace folder.
`Could not check which workspace this project is linked to, so nothing was changed: ${stripControlChars(errinstanceofError ? err.message : String(err))}`,
@@ -1034,14 +1048,25 @@ export async function linkHeadless(
0 commit comments