ai-dev-workspace

# AI Dev Workspace

> Shared Markdown task memory for developers who switch between Claude Code and Codex. Save decisions, next actions and dead ends in files you own; configured local hooks provide a task brief at session start. Install `pipx install ai-dev-workspace --pip-args='--pre'`, then run `ws start` in a Git repo to preview setup. Python 3.9+ CLI (`ws`) and local stdio MCP server; MIT licensed.

## Stable — published 0.1.0b7

- Local Markdown task records, explicit `ws remember`, `ws checkpoint` and `ws brief`.
- Seven core MCP tools by default; other tools remain callable by name.
- Claude Code and Codex have live checks on macOS. Cursor, Copilot and Gemini
  integrations are fixture-tested; Linux/Windows have CI, not live-client proof.
- Only saved information is remembered; automatic transcript capture is best-effort.
- The optional guards pack is a safety net, not a security boundary.

## Preview

- Private team sharing needs preview/review before sharing; no hosted team check yet.
- The Claude Code plugin is live-checked on beta.5 but not yet listed in
  Anthropic's official plugin directory. Install from our GitHub marketplace;
  the CLI and `ws start` in the target repo are still required.

## Released in beta.7

- Stable: `ws lesson review [--days N]` lists old lesson date stamps for manual
  review; it is read-only and never changes or deletes saved lessons.
- Preview: Codex SessionStart catch-up recovers changed transcript content for the
  locally claimed task, including resumed turns without a callback; unsafe and
  ambiguous sources are skipped, and it is fixture-tested, not live-tested with
  Codex resume.
- Preview: MCP plugin servers discover a ws-started repo from client roots and stay
  inactive for unlinked or invalid roots; Codex offers no roots.
- Stable: guards parse git push option grammar, including abbreviations of
  --delete, --prune and --mirror; they remain a safety net, not a security boundary.

## Released in beta.6

- Stable: bounded compact MCP recall, read-only stack audit and the advisory behavior pack.
- Preview: opt-in digest advice is size-only; tool output is not compressed automatically.
- Preview: worker fallback runs only declared providers and read-only roles;
  gateway delegation is checked only with a local fake server and sends a redacted brief.
- Stable: lesson promotion drafts advice only; skills packaging is format-checked,
  without a verified third-party installer run.
- Preview: claude-mem import is fixture-tested against a checkpointed SQLite schema;
  newer schemas may not import.
- Preview: Antigravity rules, MCP and SessionStart/PreToolUse hooks are fixture-tested;
  there is no signed-in live proof or automatic capture.
- Preview: Claude Code plugin needs the CLI and `ws start`; not in Anthropic's
  directory, Windows untested. Codex plugin hooks need a trusted manual desktop install;
  no MCP in the plugin, no live hook proof. Cursor plugin is fixture-tested only,
  not submitted, with no verified install command. MCP plugin server roots discovery (Preview) activates only from client roots for already started workspaces and refuses others. [Plugin limits](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/ADVANCED.md#plugin-runtime-packaging-preview).

## Coming next

Common Agent Plugins root manifest (PLG3) and Codex plugin MCP through roots (PLG5)
are parked and unavailable for Codex; codex-cli 0.155.1 offers no roots and cannot expand
plugin MCP paths, so use `ws start` for MCP. Clients that offer roots get the beta.7 Preview.

## Released documentation

- [Share memory between Claude Code and Codex](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/guides/share-memory-claude-code-codex.md)
- [Keep decisions without a background AI](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/guides/keep-decisions-without-background-ai.md)
- [Stop retrying failed approaches](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/guides/stop-retrying-failed-approaches.md)

- [README](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/README.md): install, supported clients and results with limits
- [Setup](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/SETUP.md) and [Tutorial](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/TUTORIAL.md)
- [Commands](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/COMMANDS.md) and [MCP](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/MCP.md)
- [Client verification](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/CLIENT-VERIFICATION.md): fixture and live limits
- [Overview](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/OVERVIEW.md), [Team](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/TEAM-WORKSPACE.md) and [Measurements](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/MEASUREMENTS.md)