oacp-cli 0.2.2__tar.gz → 0.3.0__tar.gz

{oacp_cli-0.2.2 → oacp_cli-0.3.0}/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.3.0] - 2026-04-29
+
+### Added
+
+- `oacp memory init|clone|pull|push|disable` subcommands for opt-in cross-machine sync of `$OACP_HOME/org-memory/**` and `$OACP_HOME/projects/*/memory/**` via a plain git repo rooted at `$OACP_HOME`. Three-state activation model: Disabled (no marker), Local-only (`init` without `--remote`), and Synced (`init --remote <url>` or `clone <url>`).
+- `oacp doctor --memory` advisory checks (10 checks covering marker presence, allowlist coverage, remote configuration, fetch/divergence state, and signing setup).
+- `oacp setup claude` now installs memory pull/push hook scripts and registers them in `.claude/settings.json` for Claude SessionStart and SessionEnd lifecycle events. Hooks are marker-gated and no-op silently unless `$OACP_HOME/.oacp-memory-repo` is present, so existing workflows are unaffected on machines that have not opted in.
+
+## [0.2.3] - 2026-04-26
+
+### Changed
+
+- `oacp watch` defaults are now notification-friendly: existing inbox messages are no longer replayed on the first scan for a target, and `message_archived` events are suppressed by default. Pass `--since=epoch` to restore replay and `--show-archived` to re-enable archive events. Reduces noise for `Monitor` and `oacp watch` consumers.
+
+### Added
+
+- `oacp watch --since=<spec>` — controls the first-run baseline cutoff. Accepts `now` (default), `epoch`, relative durations (`30s`, `5m`, `2h`, `7d`), or ISO 8601 timestamps. Only applies on first run for a target (no state file yet).
+- `oacp watch --show-archived` — opt-in flag to emit `message_archived` events. Useful for observer agents tracking another agent's inbox; disabled by default because the watching agent's own deletes are self-loops.
+
 ## [0.2.2] - 2026-04-17
 
 ### Added
@@ -110,6 +131,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Checkout step in github-release workflow job (#19)
 - Pre-release audit fixes: SHA-pinned actions, dangling doc refs (#15, #16)
 
+[0.3.0]: https://github.com/kiloloop/oacp/compare/v0.2.3...v0.3.0
+[0.2.3]: https://github.com/kiloloop/oacp/compare/v0.2.2...v0.2.3
 [0.2.2]: https://github.com/kiloloop/oacp/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/kiloloop/oacp/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/kiloloop/oacp/compare/v0.1.9...v0.2.0

{oacp_cli-0.2.2 → oacp_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oacp-cli
-Version: 0.2.2
+Version: 0.3.0
 Summary: Open Agent Coordination Protocol CLI for file-based multi-agent workflows
 Project-URL: Homepage, https://github.com/kiloloop/oacp
 Project-URL: Repository, https://github.com/kiloloop/oacp
@@ -152,7 +152,7 @@ uv tool install .
 | `oacp send` | Send a protocol-compliant inbox message (`--from` auto-inferred) |
 | `oacp inbox` | List pending messages across agents (table or `--json`) |
 | `oacp watch` | Emit inbox delta events for one agent across selected projects |
-| `oacp memory` | Archive or restore project memory files |
+| `oacp memory` | Archive, restore, or git-sync project/org memory files |
 | `oacp agent` | Manage global agent profiles (`init`, `show`, `list`) |
 | `oacp org-memory` | Initialize org-level memory at `$OACP_HOME/org-memory/` |
 | `oacp write-event` | Write an event to `org-memory/events/` |
@@ -165,11 +165,11 @@ uv tool install .
 
 **`oacp send`**: `--in-reply-to`, `--expires`, `--body-file`, `--channel`, `--dry-run`, `--json`, `--quiet`
 
-**`oacp watch`**: `--agent`, repeatable `--project`, `--all-projects`, `--json`
+**`oacp watch`**: `--agent`, repeatable `--project`, `--all-projects`, `--json`, `--since` (default `now`), `--show-archived`
 
-**`oacp doctor`**: `--fix` (auto-fix safe issues), `--json`, `-o/--output`
+**`oacp doctor`**: `--fix` (auto-fix safe issues), `--memory`, `--json`, `-o/--output`
 
-**`oacp memory`**: `oacp memory archive <project> <file>`, `oacp memory restore <project> <file>`
+**`oacp memory`**: `init [--remote URL]`, `clone <URL> [--force]`, `pull`, `push`, `disable`, `archive <project> <file>`, `restore <project> <file>`
 
 </details>
 
@@ -182,7 +182,7 @@ If `OACP_HOME` is unset, workspace commands default to `~/oacp`.
 | **Inbox/Outbox** | Async messaging between agents via YAML files in `agents/<name>/inbox/` |
 | **Review Loop** | Structured code review: `review_request` → `review_feedback` → `review_addressed` → `review_lgtm` |
 | **Quality Gate** | Merge-readiness criteria: no unresolved P0/P1 findings, deferred nits tracked |
-| **Durable Memory** | Shared `memory/` directory with an active working set plus `memory/archive/` for historical memory |
+| **Durable Memory** | Shared `memory/` directory with an active working set plus `memory/archive/` for historical memory; optional `$OACP_HOME` git sync tracks only `org-memory/**` and `projects/*/memory/**` |
 | **Dispatch States** | Task lifecycle: `received` → `accepted` → `working` → `pr_opened` → `in_review` → `done` |
 | **Safety Defaults** | Baseline rules all agents follow: no force push, no secrets in commits, stage hygiene |
 

{oacp_cli-0.2.2 → oacp_cli-0.3.0}/README.md

@@ -126,7 +126,7 @@ uv tool install .
 | `oacp send` | Send a protocol-compliant inbox message (`--from` auto-inferred) |
 | `oacp inbox` | List pending messages across agents (table or `--json`) |
 | `oacp watch` | Emit inbox delta events for one agent across selected projects |
-| `oacp memory` | Archive or restore project memory files |
+| `oacp memory` | Archive, restore, or git-sync project/org memory files |
 | `oacp agent` | Manage global agent profiles (`init`, `show`, `list`) |
 | `oacp org-memory` | Initialize org-level memory at `$OACP_HOME/org-memory/` |
 | `oacp write-event` | Write an event to `org-memory/events/` |
@@ -139,11 +139,11 @@ uv tool install .
 
 **`oacp send`**: `--in-reply-to`, `--expires`, `--body-file`, `--channel`, `--dry-run`, `--json`, `--quiet`
 
-**`oacp watch`**: `--agent`, repeatable `--project`, `--all-projects`, `--json`
+**`oacp watch`**: `--agent`, repeatable `--project`, `--all-projects`, `--json`, `--since` (default `now`), `--show-archived`
 
-**`oacp doctor`**: `--fix` (auto-fix safe issues), `--json`, `-o/--output`
+**`oacp doctor`**: `--fix` (auto-fix safe issues), `--memory`, `--json`, `-o/--output`
 
-**`oacp memory`**: `oacp memory archive <project> <file>`, `oacp memory restore <project> <file>`
+**`oacp memory`**: `init [--remote URL]`, `clone <URL> [--force]`, `pull`, `push`, `disable`, `archive <project> <file>`, `restore <project> <file>`
 
 </details>
 
@@ -156,7 +156,7 @@ If `OACP_HOME` is unset, workspace commands default to `~/oacp`.
 | **Inbox/Outbox** | Async messaging between agents via YAML files in `agents/<name>/inbox/` |
 | **Review Loop** | Structured code review: `review_request` → `review_feedback` → `review_addressed` → `review_lgtm` |
 | **Quality Gate** | Merge-readiness criteria: no unresolved P0/P1 findings, deferred nits tracked |
-| **Durable Memory** | Shared `memory/` directory with an active working set plus `memory/archive/` for historical memory |
+| **Durable Memory** | Shared `memory/` directory with an active working set plus `memory/archive/` for historical memory; optional `$OACP_HOME` git sync tracks only `org-memory/**` and `projects/*/memory/**` |
 | **Dispatch States** | Task lifecycle: `received` → `accepted` → `working` → `pr_opened` → `in_review` → `done` |
 | **Safety Defaults** | Baseline rules all agents follow: no force push, no secrets in commits, stage hygiene |
 

{oacp_cli-0.2.2 → oacp_cli-0.3.0}/SPEC.md

@@ -16,7 +16,7 @@ OACP is not a framework or SDK. It is a set of conventions, YAML schemas, and sh
 3. [Review Loop Protocol](#3-review-loop-protocol)
 4. [Cross-Runtime Sync](#4-cross-runtime-sync)
 5. [Agent Safety Defaults](#5-agent-safety-defaults)
-6. [Org-Level Memory](#6-org-level-memory)
+6. [Org-Level Memory and Sync](#6-org-level-memory-and-sync)
 7. [Kernel Script Inventory](#7-kernel-script-inventory)
 
 ---
@@ -451,7 +451,7 @@ Agents operate under least-privilege credentials:
 
 ---
 
-## 6. Org-Level Memory
+## 6. Org-Level Memory and Sync
 
 Full specification: [`docs/protocol/org_memory.md`](docs/protocol/org_memory.md)
 
@@ -459,6 +459,16 @@ Full specification: [`docs/protocol/org_memory.md`](docs/protocol/org_memory.md)
 
 Shared, cross-project memory for multi-agent organizations. Agents across projects read org-wide decisions, conventions, and events from a single location. Complements per-project memory — does not replace it.
 
+OACP can optionally sync curated memory across machines using one plain git
+repository rooted at `$OACP_HOME`. This feature is opt-in and tracks only:
+
+- `$OACP_HOME/org-memory/**`
+- `$OACP_HOME/projects/<project>/memory/**`
+
+Cross-machine inbox delivery, `agents/` runtime state, `status.yaml`, concurrent
+writer protocols, encrypted transport, and runtime-specific memory outside
+`$OACP_HOME` are out of scope.
+
 ### Directory Structure
 
 ```
@@ -470,6 +480,28 @@ $OACP_HOME/org-memory/
     └── YYYYMMDD-HHMMSS-short-slug.md
 ```
 
+When memory sync is enabled, `$OACP_HOME` also contains:
+
+```text
+$OACP_HOME/
+├── .gitignore            # positive allowlist
+├── .oacp-memory-repo     # tracked marker; activates hooks
+├── org-memory/           # tracked
+└── projects/*/memory/    # tracked
+```
+
+Canonical root `.gitignore`:
+
+```gitignore
+*
+!*/
+!.gitignore
+!.oacp-memory-repo
+!org-memory/**
+!projects/*/memory/**
+projects/*/memory/.cache/
+```
+
 ### Key Concepts
 
 - **`recent.md`** is the always-loaded cross-project context. Agents read it at session start via session-init hooks. Kept concise (~150 lines) as a rolling summary of current state, not full history.
@@ -506,11 +538,37 @@ Agents write events only (append-only). The coordinator curates topical files an
 
 - **`oacp org-memory init`** — scaffold `$OACP_HOME/org-memory/` with default files
 - **`oacp write-event`** — create an event file with proper frontmatter
+- **`oacp memory init [--remote URL]`** — initialize the `$OACP_HOME` memory git repo, marker, canonical allowlist, optional remote, and initial commit
+- **`oacp memory clone <URL> [--force]`** — clone a memory repo into `$OACP_HOME`; refuses non-empty targets unless `--force` moves the existing directory aside
+- **`oacp memory pull`** — advisory fetch plus fast-forward-only pull; warns loudly on dirty, ahead, behind, diverged, or fetch-failed states and never auto-merges
+- **`oacp memory push`** — stages only the memory allowlist, commits as `memory: <agent>@<host> <date> (N files)`, then pushes when a remote is configured
+- **`oacp memory disable`** — removes `.oacp-memory-repo` locally while leaving `.git/` intact
+- **`oacp doctor --memory`** — runs advisory memory sync checks for marker state, allowlist drift, tracked/untracked leakage, clean/ahead/behind/diverged state, remote reachability, commit staleness, `agents/` leakage, and per-project memory overlay safety
 
 ### Integration with Session Init
 
 Agents can read `org-memory/recent.md` at session start for cross-project context. This integration is runtime-specific — for example, Claude Code loads it via a session-init hook, while other runtimes may read it explicitly. Topical files and `events/` are available for on-demand reading when agents need deeper org context.
 
+Memory sync has three activation states:
+
+| State | Trigger | Behavior |
+|-------|---------|----------|
+| Disabled | No `.oacp-memory-repo` marker | Hooks no-op silently; `oacp doctor --memory` reports not configured |
+| Local-only | `oacp memory init` | Wrap-up commits memory locally for audit history; no push |
+| Synced | `oacp memory init --remote URL` or `oacp memory clone <URL>` | Session start pulls fast-forward updates; wrap-up commits and pushes |
+
+Lifecycle hooks must check for `$OACP_HOME/.oacp-memory-repo` first and exit
+without output when it is absent. Claude runtime setup installs hook scripts for
+`SessionStart` pull and wrap-up/session-end push:
+
+1. Session start runs `oacp memory pull`. It exits advisory-successfully, pulls
+   only clean behind states with `--ff-only`, and warns loudly when memory is
+   dirty, ahead, diverged, behind, or remote fetch fails.
+2. Wrap-up runs `oacp memory push`. It stages only `.gitignore`,
+   `.oacp-memory-repo`, `org-memory/**`, and `projects/*/memory/**`; commits
+   with the fixed terse message format; pushes when a remote exists; and warns
+   loudly when memory is dirty, behind, diverged, or push fails.
+
 ---
 
 ## 7. Kernel Script Inventory
@@ -532,7 +590,8 @@ Scripts marked **CLI** are exposed as `oacp` subcommands. Scripts marked **scrip
 | `agent_profile.py` | Two-tier agent profile management | CLI: `oacp agent` |
 | `send_inbox_message.py` | Compose and send inbox messages | CLI: `oacp send` |
 | `oacp_inbox.py` | List pending inbox messages | CLI: `oacp inbox` |
-| `memory_cli.py` | Archive or restore project memory files | CLI: `oacp memory` |
+| `memory_cli.py` | Archive, restore, or git-sync project/org memory files | CLI: `oacp memory` |
+| `memory_sync.py` | Shared git allowlist and memory sync helpers | imported by CLI/doctor |
 | `setup_runtime.py` | Generate runtime-specific config files | CLI: `oacp setup` |
 | `init_org_memory.py` | Scaffold org-level memory directory | CLI: `oacp org-memory` |
 | `write_event.py` | Write timestamped events to org-memory | CLI: `oacp write-event` |

{oacp_cli-0.2.2 → oacp_cli-0.3.0}/docs/guides/runtime_capability_matrix.md

@@ -1,10 +1,12 @@
 # Cross-Runtime Parity Matrix
 
-**Date**: 2026-04-17
+**Date**: 2026-04-29
 
 This is a capability comparison across 3 agent runtimes (Claude Code, Codex, Gemini), compiled from each runtime's self-report and current runtime changelogs. Use this as a reference when deciding which agent to assign for a given task.
 
-Codex was last checked against the official Codex changelog entries for app update `26.415` (2026-04-16) and `Codex CLI 0.121.0` (2026-04-15).
+Claude was last checked against Claude Code `v2.1.123`.
+
+Codex was last checked against app update `26.415`, CLI `0.123.0`, and OpenAI's GPT-5.5 launch note from 2026-04-23.
 
 ---
 
@@ -15,31 +17,32 @@ Codex was last checked against the official Codex changelog entries for app upda
 | Spawn background tasks | Yes — Task tool + Bash `run_in_background`                                 | Yes — shell background processes                                                               | Yes — `run_command` async mode                                        |
 | Spawn subagents        | Yes — typed agents (Explore, Plan, general-purpose, code-reviewer, etc.)   | Yes — native `spawn_agent` lifecycle with `default`, `explorer`, and `worker` agents          | Partial — `browser_subagent` only                                     |
 | Parallel agent teams   | Yes — TeamCreate, task lists, SendMessage, broadcast                       | Partial — parallel spawned agents are supported, but there is no team/task-list primitive      | No — parallel tool calls but no independent agent instances           |
-| MCP tools              | Yes — extensible via MCP servers                                           | Yes — MCP/plugin support depends on configured servers and marketplaces                        | Yes — MCP server support                                              |
+| MCP tools              | Yes — extensible via MCP servers                                           | Yes — MCP/plugin support with `/mcp verbose` diagnostics; configuration-dependent             | Yes — MCP server support                                              |
 | Web search             | Yes — native WebSearch tool                                                | Yes — web search/fetch tools                                                                   | Yes — native `search_web` tool                                        |
 | Browser interaction    | Partial — WebFetch (read-only, HTML→markdown)                              | Partial — web tools plus early in-app browser for local/public pages without sign-in           | Yes — full browser control (click, type, navigate, screenshot, video) |
-| File system access     | Sandboxed — configurable read/write allowlists                             | Policy-dependent per session                                                                   | Full — unrestricted                                                   |
+| File system access     | Sandboxed — configurable read/write allowlists                             | Policy-dependent per session; sandbox profiles can include deny-read rules                     | Full — unrestricted                                                   |
 | Git operations         | Yes — via Bash (may need sandbox configuration)                            | Yes — native                                                                                   | Yes — via shell                                                       |
 | GitHub CLI (gh)        | Yes — via Bash (may need sandbox configuration)                            | Yes — authenticated                                                                            | Yes — native                                                          |
 | Session memory         | Strong — auto-loaded MEMORY.md + optional MCP memory                       | Partial — app memories where available plus OACP file memory; app memories are not protocol SSOT | Partial — Knowledge Items (not directly writable), conversation logs  |
-| Interactive mode       | Yes — CLI chat with permissions, plan mode                                 | Yes — desktop app                                                                              | Yes — chat with task UI, artifacts                                    |
-| Context window         | ~1M with Opus 4.7 (auto-compaction extends indefinitely)                   | Not directly exposed; practically finite                                                       | ~1M tokens                                                            |
-| Cost model             | Token-based, visible in statusline                                         | Not surfaced in runtime                                                                        | Token-based                                                           |
-| Sandbox restrictions   | Yes — configurable allowlists                                              | Session-dependent                                                                              | None — full system access                                             |
+| Interactive mode       | Yes — CLI chat with permissions, plan mode                                 | Yes — desktop app and CLI/TUI, including Plan Mode and side conversations                      | Yes — chat with task UI, artifacts                                    |
+| Context window         | ~1M with Opus 4.7 (auto-compaction extends indefinitely)                   | Model-dependent; GPT-5.5 in Codex is documented at 400K, with no auto-compaction guarantee      | ~1M tokens                                                            |
+| Cost model             | Token-based, visible in statusline                                         | Not surfaced per session; GPT-5.5 Fast mode trades 2.5x cost for 1.5x token generation speed   | Token-based                                                           |
+| Sandbox restrictions   | Yes — configurable allowlists                                              | Session-dependent; supports deny-read policies, isolated `codex exec`, and remote sandbox requirements | None — full system access                                             |
 
 ---
 
-## 2. Unique Capabilities (Only One Runtime Has)
+## 2. Distinctive Capabilities
 
 | Capability                       | Runtime       | Details                                                                      |
 | -------------------------------- | ------------- | ---------------------------------------------------------------------------- |
 | Typed subagent orchestration     | Claude        | Multiple agent types with scoped tools and model selection                   |
 | Team coordination primitive      | Claude        | TeamCreate + task lists + assignment + broadcast + shutdown                  |
-| Plan mode                        | Claude        | Structured explore → plan → approve → implement workflow                     |
+| Plan mode                        | Claude, Codex | Claude has structured explore → plan → approve → implement; Codex CLI can move from planning into fresh-context implementation |
 | Auto-compaction                  | Claude        | Context auto-compresses, enabling unlimited session length                   |
 | Cross-session semantic search    | Claude        | MCP-based searchable memory (optional)                                       |
 | Browser automation (full)        | Gemini        | Click, type, navigate, screenshot, WebP video recording                      |
-| Image generation                 | Gemini        | Native `generate_image` tool                                                 |
+| GPT-5.5 model availability       | Codex         | Available in Codex for Plus, Pro, Business, Enterprise, Edu, and Go plans with a 400K context window |
+| Image generation                 | Codex, Gemini | Codex CLI image generation is enabled by default; Gemini has native `generate_image` |
 | URL content reading (no browser) | Gemini        | `read_url_content` fetches HTML→markdown or PDF directly                     |
 | Code outline navigation          | Gemini        | `view_file_outline`, `view_code_item` for structured exploration             |
 | PTY / terminal stdin             | Codex, Gemini | Codex: native PTY; Gemini: `send_command_input` (Claude lacks stdin support) |
@@ -68,9 +71,9 @@ Scope: skills shipped in [`kiloloop/oacp-skills`](https://github.com/kiloloop/oa
 
 | Dimension       | Claude                                                                 | Codex                                                                   | Gemini                                                               |
 | --------------- | ---------------------------------------------------------------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| Best at         | Orchestration, multi-agent teams, persistent memory, plan-then-execute | Terminal-native execution, fast iterative patching, app-assisted PR/artifact review, protocol discipline | Web research, browser automation, visual verification, large context |
-| Ideal task type | Team coordination, complex multi-file refactors, long-running sessions | Shell-heavy workflows, targeted file edits, deterministic scripts, PR follow-up, artifact review | External research, UI testing, document review, MCP integrations     |
-| Cost profile    | Flexible (haiku subagents for cheap tasks, opus for complex)           | Not directly visible                                                    | Token-based, web search has additional costs                         |
+| Best at         | Orchestration, multi-agent teams, persistent memory, plan-then-execute | Terminal-native execution, GPT-5.5 agentic coding, fast iterative patching, plan-to-implementation handoff, app-assisted PR/artifact review, protocol discipline | Web research, browser automation, visual verification, large context |
+| Ideal task type | Team coordination, complex multi-file refactors, long-running sessions | Shell-heavy workflows, long-horizon coding, targeted file edits, deterministic scripts, PR follow-up, artifact review, CLI planning passes | External research, UI testing, document review, MCP integrations     |
+| Cost profile    | Flexible (haiku subagents for cheap tasks, opus for complex)           | Per-session cost not visible; GPT-5.5 is described as more token-efficient than GPT-5.4 for Codex tasks | Token-based, web search has additional costs                         |
 
 ---
 
@@ -80,11 +83,11 @@ Scope: skills shipped in [`kiloloop/oacp-skills`](https://github.com/kiloloop/oa
 | ----------------------------- | ----------------------------- | -------------------------------------------------------------- | ---------------------- |
 | No subagents                  | —                             | Yes                                                            | Partial (browser only) |
 | No browser automation         | Yes (read-only)               | Partial (in-app browser is not full automation and excludes sign-in flows) | —                      |
-| No image generation           | Yes                           | Yes                                                            | —                      |
+| No image generation           | Yes                           | —                                                              | —                      |
 | No persistent writable memory | —                             | Partial (app memories are not a replacement for OACP durable memory) | Yes                    |
 | Sandbox friction              | Yes (configurable)            | Session-dependent                                              | —                      |
 | No team primitive             | —                             | Yes                                                            | Yes                    |
-| Context limits                | Auto-compaction mitigates     | Yes (no compaction)                                            | Large but finite       |
+| Context limits                | Auto-compaction mitigates     | Model-dependent; GPT-5.5 in Codex is 400K, but there is no documented auto-compaction behavior | Large but finite       |
 | No terminal stdin             | Yes                           | —                                                              | —                      |
 | Cost not surfaced             | —                             | Yes                                                            | —                      |
 
@@ -110,6 +113,7 @@ These are the highest-impact gaps where one runtime's limitation blocks effectiv
 | Dimension                    | Claude                           | Codex                                      | Gemini                                        |
 | ---------------------------- | -------------------------------- | ------------------------------------------ | --------------------------------------------- |
 | Max parallel tool calls      | ~10+                             | Yes (parallel independent calls)           | ~10 (practical)                               |
+| Side conversations           | No                               | Yes (`/side` in CLI/TUI)                   | No                                            |
 | Hooks system                 | Yes (pre/post tool call hooks)   | No                                         | No                                            |
 | Automation scheduling        | Yes (`CronCreate`, `ScheduleWakeup`, `/loop`, `/schedule` skills) | Yes (desktop app thread automations wake a thread on a schedule, with user request) | No                                            |
 | Notebook editing             | Yes (NotebookEdit tool)          | No                                         | No                                            |
@@ -117,6 +121,8 @@ These are the highest-impact gaps where one runtime's limitation blocks effectiv
 | Image reading (multimodal)   | Yes                              | Yes (desktop app local image/view support) | Yes                                           |
 | Artifact system              | No                               | Yes (sidebar preview for generated files) | Yes (task.md, implementation plans)           |
 | Video recording              | No                               | No                                         | Yes (WebP via browser)                        |
+| Image generation             | No                               | Yes (enabled by default in CLI)            | Yes                                           |
+| MCP diagnostics              | Partial                          | Yes (`/mcp verbose`)                       | Partial                                       |
 | Multi-file editing primitive | Edit tool (one file at a time)   | `apply_patch` (one file)                   | `multi_replace_file_content` (non-contiguous) |
 | Workflow file format         | SKILL.md with YAML frontmatter   | SKILL.md with YAML frontmatter             | Markdown with YAML frontmatter                |
 | Policy visibility at runtime | Partial (sandbox config visible) | Yes (session policy in system context)     | Yes (`SafeToAutoRun` flags)                   |
@@ -124,4 +130,10 @@ These are the highest-impact gaps where one runtime's limitation blocks effectiv
 
 ---
 
+## 8. Source Notes
+
+- GPT-5.5 Codex availability, 400K context, Fast mode, token-efficiency, and API timing come from OpenAI's 2026-04-23 release note: <https://openai.com/index/introducing-gpt-5-5/>.
+
+---
+
 *Each runtime should update only its own column. Discrepancies should be resolved by the runtime owner.*

{oacp_cli-0.2.2 → oacp_cli-0.3.0}/oacp/cli.py

@@ -24,7 +24,7 @@ Commands:
   agent          Manage global agent profiles (init, show, list)
   inbox          List pending inbox messages
   watch          Emit inbox delta events for Monitor-friendly polling
-  memory         Archive or restore project memory files
+  memory         Archive, restore, or sync memory files
   setup          Generate runtime-specific config files in a repo
   send           Send a protocol-compliant inbox message
   org-memory     Initialize org-level memory at $OACP_HOME/org-memory/
@@ -38,6 +38,7 @@ Examples:
   oacp add-agent my-project alice --runtime claude
   oacp inbox my-project --agent claude
   oacp watch --agent claude --project my-project --json
+  oacp memory init --remote git@github.com:<YOUR_ORG>/oacp-memory.git
   oacp memory archive my-project research_notes.md
   oacp setup claude --project my-project
   oacp send my-project --to iris --type notification --subject "Done" --body "Completed"

{oacp_cli-0.2.2 → oacp_cli-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oacp-cli"
-version = "0.2.2"
+version = "0.3.0"
 description = "Open Agent Coordination Protocol CLI for file-based multi-agent workflows"
 readme = "README.md"
 license = "Apache-2.0"
@@ -63,6 +63,7 @@ packages = ["oacp"]
 "scripts/oacp_inbox.py" = "oacp/_scripts/oacp_inbox.py"
 "scripts/oacp_watch.py" = "oacp/_scripts/oacp_watch.py"
 "scripts/memory_cli.py" = "oacp/_scripts/memory_cli.py"
+"scripts/memory_sync.py" = "oacp/_scripts/memory_sync.py"
 "scripts/memory_archive_common.py" = "oacp/_scripts/memory_archive_common.py"
 "scripts/promote_to_archive.py" = "oacp/_scripts/promote_to_archive.py"
 "scripts/restore_from_archive.py" = "oacp/_scripts/restore_from_archive.py"

{oacp_cli-0.2.2 → oacp_cli-0.3.0}/scripts/memory_cli.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # SPDX-FileCopyrightText: 2026 Kiloloop
 # SPDX-License-Identifier: Apache-2.0
-"""Namespace CLI for project memory archive/restore operations."""
+"""Namespace CLI for project memory archive/restore and sync operations."""
 
 from __future__ import annotations
 
@@ -14,10 +14,56 @@ from typing import Optional, Sequence
 def _build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog="oacp memory",
-        description="Archive or restore project memory files.",
+        description="Archive, restore, or sync OACP memory files.",
     )
     sub = parser.add_subparsers(dest="command")
 
+    init_parser = sub.add_parser("init", help="Initialize git sync at $OACP_HOME")
+    init_parser.add_argument(
+        "--remote",
+        default=None,
+        help="Optional git remote URL for cross-machine sync",
+    )
+    init_parser.add_argument(
+        "--oacp-dir",
+        default=None,
+        help="Override OACP home directory (default: $OACP_HOME or ~/oacp)",
+    )
+
+    clone_parser = sub.add_parser("clone", help="Clone a memory repo into $OACP_HOME")
+    clone_parser.add_argument("url", help="Git remote URL to clone")
+    clone_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Move a non-empty OACP_HOME aside before cloning",
+    )
+    clone_parser.add_argument(
+        "--oacp-dir",
+        default=None,
+        help="Override OACP home directory (default: $OACP_HOME or ~/oacp)",
+    )
+
+    pull_parser = sub.add_parser("pull", help="Fetch and fast-forward memory sync")
+    pull_parser.add_argument(
+        "--oacp-dir",
+        default=None,
+        help="Override OACP home directory (default: $OACP_HOME or ~/oacp)",
+    )
+
+    push_parser = sub.add_parser("push", help="Commit allowlisted memory and push")
+    push_parser.add_argument(
+        "--oacp-dir",
+        default=None,
+        help="Override OACP home directory (default: $OACP_HOME or ~/oacp)",
+    )
+
+    disable_parser = sub.add_parser("disable", help="Disable memory sync hooks locally")
+    disable_parser.add_argument(
+        "--oacp-dir",
+        default=None,
+        help="Override OACP home directory (default: $OACP_HOME or ~/oacp)",
+    )
+
     archive_parser = sub.add_parser(
         "archive", help="Move a non-standard memory file into memory/archive/"
     )
@@ -57,6 +103,14 @@ def _build_parser() -> argparse.ArgumentParser:
 
 def main(argv: Optional[Sequence[str]] = None) -> int:
     from _oacp_env import resolve_oacp_home
+    from memory_sync import (
+        MemorySyncError,
+        clone_memory_repo,
+        disable_memory_repo,
+        init_memory_repo,
+        pull_memory,
+        push_memory,
+    )
     from promote_to_archive import archive_memory_file
     from restore_from_archive import restore_memory_file
 
@@ -67,10 +121,37 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
         parser.print_help()
         return 2
 
+    json_output = bool(getattr(args, "json_output", False))
     oacp_root = resolve_oacp_home(explicit=args.oacp_dir)
 
     try:
-        if args.command == "archive":
+        if args.command == "init":
+            result = {"action": "init"}
+            lines = init_memory_repo(oacp_root, remote=args.remote)
+            human = "\n".join(lines)
+        elif args.command == "clone":
+            result = {"action": "clone", "url": args.url, "oacp_root": str(oacp_root)}
+            lines = clone_memory_repo(oacp_root, args.url, force=args.force)
+            human = "\n".join(lines)
+        elif args.command == "pull":
+            result = {"action": "pull"}
+            lines = pull_memory(oacp_root)
+            human = "\n".join(lines)
+        elif args.command == "push":
+            result = {"action": "push"}
+            lines, code = push_memory(oacp_root)
+            human = "\n".join(lines)
+            if json_output:
+                result["exit_code"] = code
+            if not json_output and human:
+                print(human)
+            elif json_output:
+                print(json.dumps(result, indent=2, sort_keys=True))
+            return code
+        elif args.command == "disable":
+            result = {"action": "disable"}
+            human = "\n".join(disable_memory_repo(oacp_root))
+        elif args.command == "archive":
             result = archive_memory_file(
                 args.project_name,
                 args.memory_file,
@@ -82,7 +163,7 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
                 f"memory/{result['memory_file']} -> "
                 f"memory/archive/{result['archived_file']}"
             )
-        else:
+        elif args.command == "restore":
             result = restore_memory_file(
                 args.project_name,
                 args.archived_file,
@@ -94,13 +175,16 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
                 f"memory/archive/{result['archived_file']} -> "
                 f"memory/{result['restored_file']}"
             )
-    except ValueError as exc:
+        else:
+            parser.print_help()
+            return 2
+    except (MemorySyncError, ValueError) as exc:
         print(f"Error: {exc}", file=sys.stderr)
         return 1
 
-    if args.json_output:
+    if json_output:
         print(json.dumps(result, indent=2, sort_keys=True))
-    else:
+    elif human:
         print(human)
     return 0