ai-dev-workspace

AI Dev Workspace

アシスタントは、あなたが所有する Markdown にセッションをまたいで作業内容を記憶します。Claude Code、Codex、その他のアシスタントを切り替える開発者向けの、共有可能で永続的なタスクメモリです。

クイックスタート

リポジトリに接続する前にオフラインでお試しください：ws demo · 5 分間チュートリアル · Claude Code + Codex ガイド · 削除する

pipx install ai-dev-workspace --pip-args='--pre'  # beta; omit --pip-args after a stable release
cd ~/code/myapp && ws start

pipx がない場合は、brew install pipx を実行するか、python3 -m venv ~/.ws && ~/.ws/bin/pip install --pre ai-dev-workspace を実行してください。ws start の前に、その bin ディレクトリを PATH に追加してください。

Claude Code プラグインをお使いですか？プレビュー版をご利用ください。Anthropic の公式プラグインディレクトリにはまだ掲載されていません。GitHub マーケットプレイスからインストールしてください：

/plugin marketplace add Alenroyfeild/ai-dev-workspace
/plugin install ai-dev-workspace@ai-dev-workspace

beta.5（2026-10-22）で動作確認済みです。プラグインのプレビューをご覧ください。

ws start はすべてのファイルをプレビューし、確認するまで何も書き込みません。生成されたアシスタントのフックと設定はローカル（.git/info/exclude）に保存され、タスクメモリはリポジトリの外にある ~/.ai-dev-workspace/<repo-name> に保存されます。また、ws start --undo を実行すると、リポジトリへの設定をきれいに削除できます。

視聴する（0.1.0b6 の動画）

• 2 分間の解説を見る
• 内部の仕組み：実際のコマンドと出力
• 機能紹介動画：アシスタントを切り替える · 次のステップから再開する · 行き詰まった手法 · スキル · チームワークスペース（プレビュー） · ガード · アシスタント · プラグインとしてインストール（プレビュー）
• 以前のバージョン：0.1.0b5

ユースケース

• タスクの途中で Claude Code ↔ Codex を切り替える： Claude Code で作業を開始してチェックポイントを保存し、まったく同じ概要とタスクメモリを使って Codex で続行します（ガイド）。
• 説明し直さずに翌日再開する： セッション開始時に、進行中のタスク、最近の決定事項、ブロッカーをコンテキストに直接挿入します（チュートリアル）。
• 失敗した手法を何度も試すのを防ぐ： 新しいセッションの概要には毎回、「再実行しないでください：」の下に行き詰まった手法が表示されます（ガイド）。
• 検証済みの修正内容を保持する： ws remember で決定事項や制約を記録し、新しいセッションでも以前の判断に従うようにします（コマンド）。
• リスクのあるコマンドや情報漏えいを防ぐ： オプトインの guards パックは、危険なシェル操作や、コマンドまたは書き込みファイル内のシークレットを拒否します（パック）。
• チームでドメインメモを共有する（プレビュー）： 同意に基づくプレビューを利用して、プライベート git リポジトリ経由で承認済みのナレッジを共有します（チーム）。

例

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.”

機能

機能	ステータス	内容	ドキュメントへのリンク
セッション概要	安定版	セッション開始時に、範囲を限定したタスクの記憶、決定事項、ブロッカーを注入します	概要
決定事項と引き継ぎ	安定版	ステータス、次のアクション、明示的な決定事項を保存します（ws checkpoint、ws remember）	コマンド
行き詰まった方法	安定版	失敗したアプローチを記録し、Do not redo: として表示します	コンセプト
教訓	安定版	再利用可能なタスク横断の知見とガイダンスを記録します（ws lesson）	コマンド
ws lesson review	安定版	古い日付の教訓を読み取り専用で一覧表示します（--days N）。変更や削除は行いません	コマンド
MCP サーバー	安定版	デフォルトで7つのコアツールを公開し、stdio経由のリクエストに応じて他のツールも名前で公開します	MCP
ガードパック	安定版	PreToolUseフックが、危険なコマンドやシークレットの実行前に拒否します。beta.7ではgit pushのオプション構文（省略形、--prune、--mirror）を読み取ります。これは安全策であり、セキュリティ境界ではありません	パック
規律パック	安定版	セッション中に同じコマンドが繰り返し失敗した場合、助言として注意を促します	パック
ws digest	安定版	冗長なターミナル出力を、要点を絞ったMarkdownメモに圧縮します	コマンド
ネイティブ形式のインポート	安定版	既存のClaudeおよびCodexのメモリファイルを読み込みます（ws import native）	コマンド
ws import claude-mem	プレビュー	フィクスチャでテスト済みのSQLiteコピーのインポートです。上流の新しいスキーマはインポートできない場合があります	詳細
ws audit	安定版	範囲を限定したローカルマニフェストに基づき、読み取り専用でスタックや配線の提案を行います。ログインや実際のクライアントでの検証はありません	コマンド
ws demo	安定版	コマンドを安全にテストするための、隔離されたサンドボックスリポジトリを作成します	チュートリアル
Claude Codeプラグイン	プレビュー	フックとMCPを使用します。CLIとws startが必要です。Anthropicのディレクトリには掲載されていません。Windowsでは未テストです	詳細
Codexプラグイン	プレビュー	フックを使用するには、信頼された手動のデスクトップインストールが必要です。MCPはなく、フックは実環境でテストされていません	詳細
Cursorプラグイン	プレビュー	フィクスチャでのみテスト済みです。提出されておらず、検証済みのインストールコマンドもありません	詳細
Codex SessionStartのキャッチアップ	プレビュー	対象タスクについて、変更されたトランスクリプトの内容を復元します。フィクスチャでテスト済みですが、Codexの再開機能を使った実環境ではテストされていません	詳細
MCPプラグインのルート検出	プレビュー	プラグインサーバーがクライアントのルートからws startリポジトリを検出します。Codexはルートを提供しません	詳細
ワーカーフォールバックチェーン	プレビュー	宣言されたプロバイダーと読み取り専用のロールのみが実行されます。タイムアウトは試行の失敗として扱われます	詳細
ゲートウェイプロバイダー	プレビュー	ローカルのフェイクサーバーによるテストのみです。ツールは使わず、編集済みの概要を設定済みのbase_urlに送信します	詳細
簡潔なMCPリコール	安定版	範囲を限定したメモカードと、明示的に信頼されていない詳細を提供します。CLIのスニペットは変更されません	詳細
教訓の昇格	安定版	メモの類似性が繰り返し確認されると、ドラフトを提案します。ルールは自動インストールされません	詳細
digest_file MCPツール	プレビュー	オプトインのサイズのみのアドバイスです。対象範囲を限定したファイル要約を提供し、自動圧縮は行いません	パック
行動パック	安定版	オプトインのエンジニアリングガイドラインです。助言であり、強制や学習済みのセッションパターンではありません	パック
スキルのパッケージ化	安定版	形式は確認済みです。サードパーティーのインストーラーは検証されていません。CLIとセットアップが引き続き必要です	スキル
チーム共有	プレビュー	同意に基づくプルとプレビューに対応した、プライベートなGitベースのナレッジリポジトリです	チーム
MCP Registry	プレビュー	MCPクライアントによる検出用に、server.jsonのカタログエントリーが事前設定されています	MCP

仕組み

Claude Code / Codex / Cursor / Copilot / Gemini / Antigravity
        │ (session startup & capture hooks)
        ▼
~/.ai-dev-workspace/<repo-name>/           (private, outside repo)
  ├── workspace.json                       (settings, active task, packs)
  └── vault/
      ├── Tasks/<id>.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)

メモリの保存では、バックグラウンドでモデルへの呼び出しは行いません。ws delegate --run は、宣言されたアシスタントの CLI のみを起動するか、明示的に設定されたゲートウェイに秘匿化した概要を送信します。出力は検証されていません。タスクのメモリは、所有者であるあなたが管理するプレーンな Markdown です。

結果

独立したペア調査（Codex gpt-6-luna、各コホート n=5）での測定結果は、bench/README.md をご覧ください。

条件	合格（10月11日）	合格（10月10日）
新規ベースライン（メモリなし）	0/5	0/5
ワークスペース（自動概要）	2/5	1/5
プレーンな Markdown による引き継ぎ	5/5	4/5

最新の統制された実行では、プレーンな Markdown による引き継ぎがワークスペースを上回っています（それぞれ 5/5 と 4/5 に対し、2/5 と 1/5）。一方、自動キャプチャのリリースゲートはまだ満たされていません。ワークスペースの利点は、構造化、アシスタント間の引き継ぎ、手動でのファイル管理が不要なことです。詳細と過去の実行結果は、bench/README.md および docs/MEASUREMENTS.md をご覧ください。

比較

• 組み込みのメモリファイル（CLAUDE.md、AGENTS.md）： アシスタントごとのプレーンな指示です。ai-dev-workspace は、アシスタント間の引き継ぎ、アクティブなタスクの状態、Do not redo: の制約を追加します。
• プレーンな HANDOFF.md： 手動のメモには適しています（最新のベンチマークコホートでは自動ワークスペースキャプチャを上回っています：5/5 対 2/5）。ai-dev-workspace は、アシスタント間の自動化、構造化された概要の挿入、古くなった情報の警告を追加します。
• claude-mem： フックを通じてツールの使用状況を記録し、AI で圧縮して SQLite とベクトル検索に保存します（上流ドキュメント）。明示的なコマンドを使わずにメモリを自動記録できます。ai-dev-workspace は、所有者であるあなたが管理する明示的な Markdown を保持し、メモリのためのバックグラウンドでのモデル呼び出しは行わず（明示的な委任では、宣言された CLI または設定済みのゲートウェイを呼び出す場合があります）、次のステップや行き止まりを含む、長期的に役立つ引き継ぎに重点を置いています（ガイド）。

互換性

アシスタント	状態	テストの根拠
Claude Code	対応、macOS で実機テスト済み	CI でテスト済み
Codex	対応、macOS で実機テスト済み	CI でテスト済み
Cursor	対応、フィクスチャでテスト済み。実機での報告も歓迎します	CI でテスト済み
Copilot（VS Code）	対応、フィクスチャでテスト済み。実機での報告も歓迎します	CI でテスト済み
Gemini CLI	対応、フィクスチャでテスト済み。実機での報告も歓迎します	CI でテスト済み
Antigravity	プレビュー、フィクスチャでテスト済み。ルール、MCP、SessionStart/PreToolUse フックに対応。自動キャプチャには非対応	CI でテスト済み

Cursor、Copilot（VS Code）、Gemini CLI、または Antigravity のテスターの方は、問題の報告から問題をお知らせください。

既知の制限

• クライアントの対応状況： Claude Code と Codex は macOS で実機テスト済みです。Linux と Windows は CI でのみテスト済みです。Cursor、Copilot（VS Code）、Gemini CLI、Antigravity はフィクスチャでテスト済みです。
• キャプチャはベストエフォートです： 明示的な CLI コマンド（ws remember、ws checkpoint）の動作は決定的ですが、文字起こしから合図となる語句を自動検出するキャプチャはベストエフォートです。
• ガードは安全網です： パターンマッチングにより、コマンドや書き込みファイルに含まれる一般的な危険なコマンドやシークレットをブロックしますが、回避不能なセキュリティ境界ではありません。
• チームでの共有： ローカルの HTTPS Git サーバーを使い、1 台の Mac 上で複数ユーザーのフローをテストしました。3 つの個別プロファイル、双方向の共有、生成された Claude Code と Codex のフック出力を確認しています。ホスト型 GitHub のチェックとアシスタントの実機セッションは保留中です。（ロードマップ）

プライバシーと安全性

• デフォルトでプライベート： メモリはチェックアウトパスの外部にある ~/.ai-dev-workspace/<repo-name> に保存されます。チームで共有するには、明示的にプライベートリポジトリを作成し（ws team init）、手動で確認する必要があります。
• 編集はベストエフォート： ws は既知の API キー、トークン、非公開部分（<private>...</private>）をマスクしますが、正規表現による編集はベストエフォートであり、運用上のシークレット管理に代わるものではありません。
• ガードは安全網： guards PreToolUse フックは、コマンドや書き込み対象ファイルに含まれる既知のリスクのあるシェルパターンやシークレットをブロックします。ただし、これは安全網であり、回避不可能なセキュリティ境界ではありません。

今後の予定

• Common Agent Plugins マニフェスト（PLG3）： Codex がプラグインフックを失わずにルートマニフェストを読み込めるようになるまで、保留され、利用できません。
• ルート経由の Codex プラグイン MCP（PLG5）： Codex では保留され、利用できません。codex-cli 0.155.1 はルートを提供せず、プラグインの MCP パスを展開できないため、MCP には ws start を使用してください。ルートを提供するクライアントでは beta.7 Preview を利用できます。

ドキュメント

• 開始する： 5 分間チュートリアル · セットアップガイド · デモの手順 · クライアント間のガイド
• 使う： CLI コマンド · パックカタログ · スキルの配布 · MCP サーバー · 高度な使い方
• ガイド： バックグラウンド AI なしで決定事項を保持する · 行き詰まった方法の再試行をやめる
• チーム： チームでの利用 · チームワークスペースのセットアップ
• リファレンス： 概要 · アーキテクチャ · ベンチマーク測定 · クライアントの検証 · Windows のサポート · ロードマップ

ステータスとコントリビューション

ai-dev-workspace はパブリックベータ版です（PyPI の v0.1.0-beta.7）。予定されている改善はロードマップで管理しています。バグ報告やフィードバックは、問題が発生した場合からお寄せください。

MIT License のもとで公開されています。