Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

docs(command-code): narrow managed acceptance gate

AkitaOnRails7a6490c13483
diff --git a/docs/install.md b/docs/install.md
index 9a18d71f..fd565cf3 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -780,10 +780,15 @@ ai-memory finalize-session --agent command-code --session-id <uuid>
ai-memory does not install Command Code Mods. Mods are currently documented
as experimental, run unsandboxed, and do not provide the same stable native
session identity at every callback. Managed `ai-memory run command-code`
-support is also withheld until a logged-in acceptance run proves the current
-session-store layout, exact resume selector, checkout ownership, read-only
-transcript import, `--yolo` translation, and Windows executable behavior.
-Direct `cmd`, `cmdc`, or `command-code` launches remain unchanged.
+support is also withheld. Command Code documents append-only JSONL transcripts
+under `~/.commandcode/projects/<project-slug>/`, native `--continue`,
+`--resume`, and `--session` selectors, `--yolo`, and the Windows `cmdc` alias.
+It does not document the JSONL record schema needed for bounded visible-event
+import. A logged-in acceptance run must still supply sanitized structural
+fixtures and validate checkout matching, incremental import, resume identity,
+normal-exit finalization, and native Windows behavior before ai-memory manages
+those sessions. Direct `cmd`, `cmdc`, or `command-code` launches remain
+unchanged.
### Kiro CLI
diff --git a/docs/managed-workstreams.md b/docs/managed-workstreams.md
index cd697ce1..3a2ef714 100644
--- a/docs/managed-workstreams.md
+++ b/docs/managed-workstreams.md
@@ -236,11 +236,15 @@ is labelled completed evidence and must never be replayed as a pending call.
Command Code is intentionally absent from this table. Its first-party MCP and
stable lifecycle-hook integration does not imply managed resume support.
-Before adding a managed adapter, a logged-in current release must prove the
-session-store layout, exact resume selector, checkout validation, read-only
-visible-event extraction, dangerous-mode translation, normal-exit finalization,
-and the `cmdc` executable path on native Windows. Experimental Mod APIs are not
-a substitute for those native-session acceptance artifacts.
+The official session contract establishes append-only JSONL transcripts at
+`~/.commandcode/projects/<project-slug>/<session-id>.jsonl`, native
+`--continue`, `--resume`, and `--session` selectors, `--yolo`, and `cmdc` as
+the native Windows alias. The record-level JSONL schema is not documented.
+Before adding a managed adapter, a logged-in current release must therefore
+supply sanitized structural fixtures and validate project-slug ownership,
+branch-aware visible-event extraction, incremental append behavior, resume
+identity, normal-exit finalization, and native Windows execution. Experimental
+Mod APIs are not a substitute for those native-session acceptance artifacts.
An explicit native selector such as Claude's `--resume`, OpenCode's `--session`,
Codex's `resume`, or Antigravity's `--conversation` / `--continue` wins.
diff --git a/docs/mcp-install.md b/docs/mcp-install.md
index 175fa6e7..a5d1cc57 100644
--- a/docs/mcp-install.md
+++ b/docs/mcp-install.md
@@ -834,14 +834,18 @@ envelope, and inject pending handoffs with
`Stop` is only a turn boundary. Run `ai-memory finalize-session --agent
command-code` after the final turn (or add `--session-id <uuid>` when several
sessions share the project). ai-memory does not generate a Mod: that API is
-experimental and unsandboxed. A managed adapter remains deferred until a real
-logged-in client acceptance test supplies safe fixtures for exact resume,
-checkout ownership, transcript import, dangerous mode, and native Windows.
+experimental and unsandboxed. Command Code officially documents its
+project-scoped append-only JSONL location, native resume selectors, `--yolo`,
+and Windows aliases, but not the JSONL record schema. A managed adapter remains
+deferred until a real logged-in client acceptance test supplies sanitized
+structural fixtures and validates checkout ownership, incremental visible-event
+import, resume identity, normal-exit finalization, and native Windows execution.
Sources: <https://commandcode.ai/docs/mcp>,
<https://commandcode.ai/docs/hooks>,
<https://commandcode.ai/docs/mods>, and
-<https://commandcode.ai/docs/reference/cli>.
+<https://commandcode.ai/docs/reference/cli>, plus the native-session contract at
+<https://commandcode.ai/docs/sessions>.
## Kiro CLI