CapsStack

Step away. Come back caught up.

CapsStackは、AIコーディングエージェントへ作業を任せて席を離れたあと、戻った瞬間に状況へ追いつくためのmacOSアプリです。Codex、Claude Code、OpenCode、Pi、GitHub Copilot、Kilo Code、Goose、Qwen Code、Continue、Gemini CLIのセッションを、進捗・判断・ブロッカー・次の一手が分かる「復帰ブリーフ」にまとめます。

AIを速くするのではなく、人間がAIの作業状態へ戻るまでの時間を短くするためのツールです。

1. AIエージェントへ作業を任せ、離席するときにCaps LockをON
2. CodexやClaude Codeなどが作業している間、その場を離れる
3. 戻ってCaps LockをOFFにすると、離席中のセッションから復帰ブリーフを生成

Caps Lock ON   →   Step away   →   Agents keep working
Caps Lock OFF  →   Return brief: progress / decisions / blockers / next steps

• MacでCodex Desktopや各種CLIへ数分〜数十分のタスクを任せる
• Desktop・IDE・ターミナルのコーディングエージェントを使い分ける
• 離席後、長い会話ログやGit diffを読む前に現在地を把握したい
• エージェントが「何をしたか」だけでなく「次に何をすべきか」を知りたい

CodexはCLI・Desktop・IDEの共有ローカル履歴を、OpenCodeはDesktop・IDE・CLIで共有されるセッションを公式CLIのexport境界から収集します。一般のChatGPT会話やCursor固有Agentなど、安定した履歴取得境界がないGUI作業は退席前メモで補足できます。

• 収集元は10種類の対応エージェントから独立して複数選択（CodexとOpenCodeはCLI・Desktop・IDEを統合）
• Caps Lock ON区間の記録をプロジェクトごと、その中のセッションごとに整理
• 復帰時に必要な「次の一手」「確認待ち」「問題」「進捗」「決定」「発見」「検証」などだけをAIが選び、出所のプロジェクトとセッションを付けて最大12件に整理
• 5秒未満の誤操作と、対応エージェントの活動も退席前メモもない区間は履歴に保存しない
• 要約担当CLIは収集元と無関係に選択
• 要約担当ごとにモデルとReasoning（CLI固有のeffort / variant / thinking）を指定（Codex、OpenCode、Pi、Kilo CodeはCLIからモデル一覧を取得して選択可能）
• 主担当が失敗した場合は利用可能な別CLIへ自動フォールバック
• 退席前に任意メモを入力でき、CLIログがなくても要約を実行（GUI版エージェントの作業補足に対応）
• 履歴の要約をクリップボードへコピー、Markdownとして書き出し
• 元セッションをresumeせず、隔離した一時ディレクトリで要約のみ実行
• 成功時は生ログを削除し、失敗時だけ再要約用に保持
• 履歴ウィンドウ、macOS通知、.pkg生成に対応
• 完了ブリーフから任意の4択で役立ち度を回答可能（記述式フィードバックなし）
• 匿名テレメトリは初回セットアップで明示的にオプトインした場合だけ送信（SDKの自動収集・Session Replayは無効）

• macOS 14以降
• Xcode 26または対応するSwift toolchain
• 要約に使うCLIがインストール・認証済みであること

表示言語はmacOSの「優先する言語」の先頭に合わせます。日本語と英語に対応し、その他の言語では英語へフォールバックします。システム言語を変更した場合はCapsStackを再起動すると反映されます。

初回起動時の収集元と要約担当は、このMacで検出できたCLI（または読めるローカル履歴）から自動設定されます。CodexとClaude Codeのどちらか一方しか入っていない場合でも、未導入側を既定で呼び出しません。利用可能な設定値は自動設定後も保持され、未導入の要約CLIは実行せず、自動フォールバックが有効なら利用可能なCLIへ切り替えます。別のCLIを後から追加した場合は設定画面から収集元・要約担当を選べます。旧バージョンから移行する場合も、CLIも履歴も使えない収集元だけは一度だけ自動停止します。

OpenCode、Kilo Code、GooseはDB-backed storageを直接解釈せず、公式CLIの一覧・export境界を使います。Gemini CLIとContinueは複数行JSON、Qwen Codeは新旧JSONLの保存配置を読み取ります。GitHub Copilotは events.jsonl だけを読み、同じセッションフォルダにあるcheckpointやworkspace artifactを本文として取り込みません。Kilo Codeは公式の無人実行にツール無効化・読み取り専用・設定分離の安定した境界が公開されるまで、収集専用です。

要約時は対応する全CLIで元の作業ディレクトリをcwdにせず、一時ディレクトリを使います。Copilotは利用可能ツールと組み込みMCPを空にし、Gooseは全ツール無効のChat mode、Qwenはsafe mode・tool deny・tool-call上限0を併用します。OpenCode要約のセッションDBも一時ディレクトリへ隔離します。

モデルIDとReasoningの有効値はCLIやモデルごとに変わります。Codex、OpenCode、Piは公式CLIのモデル一覧境界から取得した候補を設定画面で選択できます。その他のCLIは安定した一覧取得境界がないためモデルIDを自由入力できます。どのCLIも空欄なら各CLIの既定値を使います。OpenCodeのvariantはモデルごとに有効値が異なります。Kilo Code、Continue、Gemini CLIは安全な無人要約境界を保守的に評価し、現時点では収集専用です。

Cursor CLIは非対話モードが書込み権限を持ち、Aiderはプロジェクト横断の中央履歴/export契約がなく、Kilo Codeは安全な無人要約境界がなく、Roo CodeはCLI境界が移行中のため、名前だけの対応にはしていません。安定した公式境界が確認できた時点で追加します。

設定の収集元はクライアント別ではなくエージェント単位です。「Codex」を有効にするとCLI・Desktop・IDEのセッションをまとめて収集し、セッション別要約には「Codex Desktop」「Codex CLI」など実際のクライアントを表示します。「OpenCode」は公式exportがクライアント種別を公開しないため「OpenCode 共有セッション」と表示し、DesktopアプリだけでCLIがない場合は設定画面でexport用CLIが必要だと案内します。

画面収録やAccessibility監視、非公開DBの直接解析は行いません。一般のChatGPT会話やCursor固有Agentなど、安定した公開履歴を読めないGUIエージェントは、メニューバーの「退席前メモ...」から補足すると復帰時の要約資料に含まれます。

対応セッションが一件も検出されず、退席前メモだけがある場合は、メモ単体を要約対象として扱います。これにより、未対応GUIのワークフローや短い外出でも履歴が空になりません。

実装時の照合先： Codex exec CLI、Claude Code CLI、OpenCode CLI、Pi usage、GitHub Copilot CLI、Kilo CLI、Goose CLI、Qwen headless mode、Continue headless mode、Gemini session management。

設定画面のエージェント画像はネット上の公式素材を取得してローカル同梱しています。Gemini CLIは公式Brand Kitのアイコン、Kilo Code・Goose・Qwen Code・Continueは各公式GitHub組織の公開プロフィール画像を使用します。アプリ起動時に外部画像ホストへ通信しません。

swift test
./script/build_and_run.sh --verify

CodexアプリのRunボタンも ./script/build_and_run.sh を呼び出します。

CLIは履歴の参照、退席前メモの受け渡し、対応エージェントCLIの検出を行います。履歴やメモはmacOSアプリと同じローカル保存先を使い、生ログにはアクセスしません。

開発時は、macOSの大文字小文字非区別ファイルシステムでアプリ名と衝突しないSwiftPM product名を使います。

swift run capsstack-cli --help
swift run capsstack-cli status --json
swift run capsstack-cli history latest --markdown
printf '%s' '次は回帰テストを実行' | swift run capsstack-cli memo set --stdin --json

.app / .pkg には CapsStack.app/Contents/Helpers/capsstack として同梱されます。Contents/MacOS/CapsStack と同じディレクトリに小文字名を置くと、macOS標準の大文字小文字非区別ファイルシステムでアプリ本体と衝突するためです。

/Applications/CapsStack.app/Contents/Helpers/capsstack status

主なコマンド：

検証済みのCodexプラグインは plugins/capsstack にあります。プラグインには次のSkillsを同梱しています。

• capsstack-context: 退席前の作業状況を短いメモとして保存し、連携状態を確認
• capsstack-history: 最新または指定した復帰要約をJSON / Markdownで安全に取得

Skillsは CAPSSTACK_CLI、リポジトリ内の開発ビルド、PATH、/Applications/CapsStack.app/Contents/Helpers/capsstack の順でCLIを解決します。プラグインの配布時は plugins/capsstack ディレクトリをCodex marketplaceのplugin sourceとして利用できます。

GitHubで新しい空のリポジトリを作成します。初回の履歴をローカルで作るため、作成時にREADME、.gitignore、Licenseの自動生成は選択しません。

ローカルでコミット対象を確認してから、初回コミットを作成します。.gitignore によりビルド生成物、ローカルのCodex設定、環境ファイル、秘密鍵・署名ファイルは対象外になります。

cd /path/to/CapsStack
git status --short --ignored
git add .
git status --short
git diff --cached --check
git diff --cached
git commit -m "Initial commit"
git branch -M main

コミット内容を確認したら、GitHubリポジトリを origin として登録してpushします。OWNER と REPOSITORY は自分の値に置き換えてください。

SSHを使う場合：

git remote add origin git@github.com:OWNER/REPOSITORY.git
git push -u origin main

HTTPSを使う場合：

git remote add origin https://github.com/OWNER/REPOSITORY.git
git push -u origin main

すでに origin が登録済みなら git remote set-url origin ... を使います。GitHub CLIやSSH agentなどで認証し、アクセストークンをURLやソースに直接書かないでください。2回目以降は git push だけで更新できます。

ローカル確認用のad-hoc署名パッケージ：

./script/build_pkg.sh

Developer ID署名：

DEVELOPER_ID_APPLICATION="Developer ID Application: ..." \
DEVELOPER_ID_INSTALLER="Developer ID Installer: ..." \
./script/build_pkg.sh

outputs/CapsStack.pkg はバージョンごとに1つだけ保持します。同じバージョンがすでにある場合は再生成せず、異なるバージョンの場合だけ新しいパッケージを作ってから置き換えます。生成中に別のパッケージ生成が走った場合も、重複生成せず終了します。

バージョンを更新する場合：

CAPSSTACK_VERSION="0.2.0" CAPSSTACK_BUILD="0.2.0" ./script/build_pkg.sh

notarytoolの認証情報をKeychainへ保存した後：

NOTARY_PROFILE="capsstack-notary" ./script/notarize.sh

CapsStackはセッション本文、退席前メモ、作業ディレクトリ、ファイルパスを独自サーバーへ送信しません。ただし要約CLIは各サービスの設定に従って入力を処理します。要約成功後、生ログと一時資料は削除されます。

匿名テレメトリは、初回セットアップで明示的にONにした場合だけ、次の集計イベントをPostHogへ送信します。初期状態はOFFで、同意前はSDKも初期化しません。 選択は設定の「セットアップを開く」から後で見直せます。

• setup_completed: セットアップ完了、収集元数のバケット、要約担当、telemetry_enabled=true
• first_return_brief_completed: このインストールで最初に永続化された成功ブリーフ、担当CLI、フォールバック使用、離席時間・要約時間のバケット
• return brief consumed: 完了ブリーフの表示・コピー・書き出し操作（既存イベント名とプロパティを維持）
• brief_feedback_submitted: 完了ブリーフへの任意のワンクリック回答（helpful / missing_important_context / too_verbose / incorrect_or_misleading）

従来の return brief requested / return brief completed / return brief empty / return brief failed、summary retry …、provider connection tested も、従来どおり集計値だけを送信します。 既存のスペース区切りイベント名は互換性のため変更せず、新しいイベントだけsnake_caseを使います。自動ライフサイクル収集、画面遷移の自動収集、Session Replay、LLMのプロンプト／出力収集、記述式フィードバックは使用しません。履歴、メモ、セッション本文、作業ディレクトリ、ファイルパス、セッション／モデルID、認証情報、生エラーはイベントへ含めません。PostHogプロジェクトが設定されていないビルドでは、イベントは送信されません。

PostHogを有効にした配布用ビルドは、公開プロジェクトトークンをビルド時に埋め込みます。トークンや送信先はソースへコミットせず、次の環境変数で指定します。

CAPSSTACK_POSTHOG_PROJECT_TOKEN="phc_..." \
CAPSSTACK_POSTHOG_HOST="https://us.i.posthog.com" \
./script/build_and_run.sh --verify

EU Cloudを使う場合はCAPSSTACK_POSTHOG_HOST="https://eu.i.posthog.com"を指定します。PostHogのプロジェクトトークンは公開識別子ですが、個人APIキーやシークレットキーは使用・保存しないでください。

Caps Lockを物理スイッチとして扱う軽快な体験はCapsomniaに着想を得ています。CapsStackはコード、アセット、文言、画面構成を流用せず、セッション収集と復帰要約のために独立実装しています。スリープ制御や特権ヘルパーも含みません。