ai-dev-workspace

Name: ai-dev-workspace
Author: Alenroyfeild

作者：Alenroyfeild版本 0.1.0b7i★ –i在你的电脑上运行

注册名称io.github.Alenroyfeild/ai-dev-workspace

安装

概览

作者提供的说明（英文原文）

Local Markdown task memory shared by Claude Code and Codex over stdio MCP.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 文档、表格与办公

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
注册中心没有列出需要填写的密钥。

你需要

PyPI已安装 Python 的 uv（用于 uvx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "ai-dev-workspace": {
      "command": "uvx",
      "args": [
        "ai-dev-workspace"
      ]
    }
  }
}

在终端中运行这条命令

claude mcp add ai-dev-workspace -- uvx ai-dev-workspace

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "ai-dev-workspace": {
      "command": "uvx",
      "args": [
        "ai-dev-workspace"
      ]
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "ai-dev-workspace": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ai-dev-workspace"
      ]
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月6日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 Alenroyfeild 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“文档、表格与办公”中的其他服务器比较i

星标数多于此分类中其他 2174 个服务器的 0%
发布到注册中心的时间比此分类中其他 2174 个服务器的 91% 更新
基础检查结果等于或优于此分类中其他 2174 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

ai-dev-workspace 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.1.0b7）于前天进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它？

同一分类中有：Agent-Native Calendar, Excel MCP Server, MCP Server for Excel

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Agent-Native Calendar

作者：BuilderIO

Agent-Native Google Calendar - manage events, sync, and public booking

在云端运行★ 7,620MIT2个月前更新

安装

Excel MCP Server

作者：haris-musa

Create and edit Excel files with AI: charts, PivotTables, formulas. No Excel needed.

在你的电脑上运行★ 4,276MIT6天前更新

安装

MCP Server for Excel

作者：sbroenne

Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.

在你的电脑上运行★ 847MIT3天前更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

AI Dev Workspace

Your assistant remembers work between sessions in Markdown you own. Shared, durable task memory for developers who switch between Claude Code, Codex, and other assistants.

Quick start

Try offline before connecting a repo: ws demo · 5-minute tutorial · Claude Code + Codex guide · remove it

pipx install ai-dev-workspace --pip-args='--pre'  # beta; omit --pip-args after a stable release

cd ~/code/myapp && ws start

No pipx? brew install pipx, or python3 -m venv ~/.ws && ~/.ws/bin/pip install --pre ai-dev-workspace; put its bin directory on PATH before ws start.

Prefer a Claude Code plugin? Preview. Not yet listed in Anthropic's official plugin directory; install from our GitHub marketplace:

/plugin marketplace add Alenroyfeild/ai-dev-workspace

/plugin install ai-dev-workspace@ai-dev-workspace

Live-checked on beta.5 (2026-10-22). See the [plugin preview](docs/ADVANCED.md#claude-code-plugin-preview).

ws start previews every file and writes nothing until you confirm. Generated assistant hooks and configs stay local (.git/info/exclude), task memory lives outside the repo in ~/.ai-dev-workspace/ , and ws start --undo cleanly removes repo wiring.

Watch (videos for 0.1.0b6)

Watch the 2-minute explainer
Under the hood: real commands, real output
Feature shorts: Switch assistants · Resume the next step · Dead ends · Skills · Team workspace (Preview) · Guards · Assistants · Install as a plugin (Preview)
Earlier editions: 0.1.0b5

Use cases

Switch Claude Code ↔ Codex mid-task: Start in Claude Code, save a checkpoint, and continue in Codex with the exact same brief and task memory (guide).
Resume tomorrow without re-explaining: Inject active tasks, recent decisions, and blockers directly into context at session start (tutorial).
Stop retrying failed approaches: Dead ends appear under Do not redo: in every fresh session brief (guide).
Keep verified corrections: Record decisions or constraints with ws remember so fresh sessions follow earlier rulings (commands).
Block risky commands and leaks: Opt-in guards pack denies dangerous shell operations and secrets in commands or written files (packs).
Share domain notes with a team (preview): Share approved knowledge via private git repository with consent-based previews (team).

Example

Session 1 — You: “Empty email returns missing_email; leave signup unchanged.”

Assistant: “I’ll trace login and keep the decision with this task.” You: “Save a checkpoint and stop here.”

Session 2 — You: “Continue the login fix.” Assistant: “The saved note says return missing_email and leave signup unchanged.” You: “Yes, continue.”

Features

Feature	Status	What it does	Docs link
Session brief	Stable	Injects bounded task memory, decisions, and blockers at session start	Overview
Decisions & handoffs	Stable	Saves status, next action, and explicit rulings (`ws checkpoint`, `ws remember`)	Commands
Dead ends	Stable	Records failed approaches and displays them as `Do not redo:`	Concepts
Lessons	Stable	Captures reusable cross-task takeaways and guidance (`ws lesson`)	Commands
`ws lesson review`	Stable	Read-only list of lessons with old date stamps (`--days N`); changes or deletes nothing	Commands
MCP server	Stable	Exposes 7 core tools by default; others by name on request via stdio	MCP
Guards pack	Stable	PreToolUse hook denies risky commands and secrets before execution; beta.7 reads git push option grammar (abbreviations, `--prune`, `--mirror`); a safety net, not a security boundary	Packs
Discipline pack	Stable	Advisory nudge when the same command fails repeatedly in a session	Packs
`ws digest`	Stable	Compresses verbose terminal output into focused markdown notes	Commands
Native imports	Stable	Reads existing Claude and Codex memory files (`ws import native`)	Commands
`ws import claude-mem`	Preview	Fixture-tested SQLite copy import; newer upstream schemas may not import	Advanced
`ws audit`	Stable	Read-only stack/wiring suggestions from bounded local manifests; no login or live-client proof	Commands
`ws demo`	Stable	Creates an isolated sandbox repo to test commands safely	Tutorial
Claude Code plugin	Preview	Hooks + MCP; needs CLI + `ws start`; not in Anthropic directory; Windows untested	Advanced
Codex plugin	Preview	Hooks need a trusted manual desktop install; no MCP; hooks not live-tested	Advanced
Cursor plugin	Preview	Fixture-tested only; not submitted; no verified install command	Advanced
Codex SessionStart catch-up	Preview	Recovers changed transcript content for the claimed task; fixture-tested, not live-tested with Codex resume	Advanced
MCP plugin roots discovery	Preview	Plugin server finds a `ws start` repo from client roots; Codex offers no roots	Advanced
Worker fallback chain	Preview	Only declared providers and read-only roles run; timeout is a failed attempt	Advanced
Gateway provider	Preview	Local fake-server tests only; sends a redacted brief to configured base_url, without tools	Advanced
Compact MCP recall	Stable	Bounded note cards and explicit untrusted detail; CLI snippets unchanged	Advanced
Lesson promotion	Stable	Repeated-note similarity suggests a draft; no automatic rule installation	Advanced
`digest_file` MCP tool	Preview	Opt-in size-only advice; scoped file summaries, no automatic compression	Packs
Behavior pack	Stable	Opt-in engineering guidelines; advice, not enforcement or learned session patterns	Packs
Skills packaging	Stable	Format checked; third-party installer not verified; CLI and setup still required	Skills
Team sharing	Preview	Private git-backed knowledge repo with consent-based pulls and previews	Team
MCP Registry	Preview	Pre-configured `server.json` catalog entry for MCP client discovery	MCP

How it works

Claude Code / Codex / Cursor / Copilot / Gemini / Antigravity

│ (session startup & capture hooks) ▼ ~/.ai-dev-workspace/ / (private, outside repo) ├── workspace.json (settings, active task, packs) └── vault/ ├── Tasks/ .md (status, next action, decisions, blockers) └── Learnings.md (reusable cross-task lessons & dead ends) ▲ │ (MCP stdio connection: 7 core tools by default; others by name) Local Assistant (MCP client)

Memory storage makes no background model calls. ws delegate --run starts only declared assistant CLIs or sends a redacted brief to an explicitly configured gateway; output is unverified. Task memory is plain Markdown you own.

Results

Measured in bench/README.md across independent paired investigations (Codex gpt-6-luna, n=5 per cohort):

Arm	Pass (October 11)	Pass (October 10)
Fresh baseline (no memory)	0/5	0/5
Workspace (automatic brief)	2/5	1/5
Plain Markdown handoff	5/5	4/5

The latest controlled runs show the plain Markdown handoff beating the workspace (5/5 and 4/5 against 2/5 and 1/5), with the automatic-capture release gate still unmet. The win for the workspace is structure, cross-assistant handoff, and avoiding manual file management. Details and earlier runs: bench/README.md and docs/MEASUREMENTS.md.

Compared with

Built-in memory files (CLAUDE.md, AGENTS.md): Plain instructions per assistant; ai-dev-workspace adds cross-assistant handoffs, active task state, and Do not redo: constraints.
A plain HANDOFF.md: Works well for manual notes (and beat automatic workspace capture in latest benchmark cohorts: 5/5 vs 2/5); ai-dev-workspace adds cross-assistant automation, structured brief injection, and staleness warnings.
claude-mem: Captures tool use through hooks and compresses it with AI into SQLite + vector search (upstream docs), providing automatic memory capture without explicit commands; ai-dev-workspace keeps explicit Markdown you own, makes no background model calls for memory (explicit delegation can call declared CLIs or a configured gateway), and focuses on durable handoffs with next steps and dead ends (guide).

Compatibility

Assistant	Status	Test proof
Claude Code	supported, tested live on macOS	CI-tested
Codex	supported, tested live on macOS	CI-tested
Cursor	supported, fixture-tested; live reports welcome	CI-tested
Copilot (VS Code)	supported, fixture-tested; live reports welcome	CI-tested
Gemini CLI	supported, fixture-tested; live reports welcome	CI-tested
Antigravity	Preview, fixture-tested; rules, MCP, SessionStart/PreToolUse hooks; no automatic capture	CI-tested

Testers on Cursor, Copilot (VS Code), Gemini CLI, or Antigravity: please share problems through Something broke.

Known limits

Client coverage: Claude Code and Codex are live-tested on macOS; Linux and Windows are CI-tested only. Cursor, Copilot (VS Code), Gemini CLI, and Antigravity are fixture-tested.
Capture is best-effort: Explicit CLI commands (ws remember, ws checkpoint) are deterministic; automatic transcript cue-word capture is best-effort.
Guards are a safety net: Pattern matching blocks common risky commands and secrets in commands or written files, bu

只显示了开头部分；其余内容请在仓库中阅读