WidgetStore CLI：ほかの AI エージェントから操作

%BRAND% デスクトップ版にはコマンドラインツール widgetstore が付いています。ほかの AI エージェント（Claude Code、Codex、Gemini CLI、Cursor など）やスクリプトから %BRAND% を操作できます。

• クラウドの機能（MCP サーバーと同じツール）：スペースの確認、ウィジェットの変更、マイデータへの記録の追加、ToDo の追加、フォーカスの記録、AI でスペース作成など。ウェブサイトに新しい機能が増えると、自動でコマンドにも現れます。
• このパソコンの機能：集中タイマーの開始・終了、ウィジェットをデスクトップに置く、ページやランチャーを開く、通知を出す、AI 使用量を読む、ローカルのエージェントにタスクを任せる。

インストール

デスクトップ版のサイドバー エージェント →「コマンドライン」→ コマンドラインツールをインストール：

• macOS：/usr/local/bin/widgetstore に置きます（パスワードの入力を求められます）。キャンセルすると ~/.local/bin に置き、PATH への追加方法を表示します。
• Windows：アプリのフォルダをユーザーの PATH に追加します（管理者権限は不要）。新しいターミナルから使えます。
• Linux：.deb / .rpm でインストールした場合はすでに /usr/bin/widgetstore があります。AppImage は ~/.local/bin/widgetstore にリンクします。

新しいターミナルで widgetstore status を実行して確認してください。

ログイン

• デスクトップ版のあるパソコン（おすすめ）：「コマンドライン」で アカウントを接続 を押し、ブラウザで許可する権限を確認します（不要なものは外せます）。許可はシステムのキーチェーン（Linux では本人だけが読めるファイル）に保存され、コマンドラインのプロセスはトークンを見られません。呼び出しはデスクトップ版が代わりに行います。ウェブサイトの「設定 → API と AI の接続 → 接続済みの AI アプリ」でいつでも解除できます。
• デスクトップ版のないマシン（サーバー / CI）：ウェブサイトで個人トークンを作り、WIDGETSTORE_TOKEN=wsp_… を設定するか、widgetstore login --token -（標準入力から読み込み、キーチェーンに保存）を使います。

使い方

widgetstore tools                    # すべてのコマンド（クラウド + このパソコン）
widgetstore get_my_space --json      # 機械が読める出力
widgetstore add_record --help        # コマンドのオプション
widgetstore focus_start --minutes 25 --task "週報"
widgetstore ask claude "最近のコミットからリリースノートを書いて" --cwd ~/code/app --wait
widgetstore mcp                      # ローカル MCP サーバー（stdio）

• オプションは各ツールの JSON スキーマから作られます：--名前 値、--フラグ / --no-フラグ、配列は同じオプションを繰り返し、--args '{"…":…}' でまとめて指定。値に @ファイル や @-（標準入力）も使えます。
• --json の出力は決まった形です：成功は {"ok":true,"tool":…,"data":…,"text":…}、失敗は {"ok":false,"error":{"code","message","exit"}}。
• 終了コード：0 成功 · 1 ツールやサーバーのエラー · 2 使い方の誤り · 3 未ログインまたは権限不足 · 4 デスクトップ版が起動していない（ローカルのコマンド）· 5 デスクトップ版で拒否された。

エージェントに追加する

widgetstore mcp をローカルの MCP サーバー（同じツール）として 1 行で追加できます：

エージェント	コマンド / 設定
Claude Code	claude mcp add widgetstore -- widgetstore mcp
Codex CLI	codex mcp add widgetstore -- widgetstore mcp
Gemini CLI	gemini mcp add widgetstore widgetstore mcp
Cursor	~/.cursor/mcp.json：{"mcpServers":{"widgetstore":{"command":"widgetstore","args":["mcp"]}}}
opencode	opencode.json：{"mcp":{"widgetstore":{"type":"local","command":["widgetstore","mcp"]}}}

MCP を使わず、プロジェクトの AGENTS.md / CLAUDE.md に書いておくこともできます（「コマンドライン」の画面にコピー用があります）：

## WidgetStore
- The `widgetstore` CLI is installed. Run `widgetstore tools --json` to see every command and its JSON schema.
- Call a tool with `widgetstore <tool> --option value --json` (exit code 0 = ok).
- Local actions (opening pages, pinning widgets, agent tasks) need the user to confirm in the WidgetStore desktop app. Cloud writes are logged and can be undone with `widgetstore undo`.

安全

• 権限はサーバー側でトークンの範囲に従って判定され、変更はすべて操作ログに残り、元に戻せます（widgetstore undo）。データの削除、アカウントの変更、支払いができるコマンドはありません。火花を使うツールはコマンドラインでは初期設定でオフです（「コマンドライン」→ 安全 でオンにできます）。
• このパソコン向けのコマンドはローカルの経路を使い、同じ OS ユーザーしか接続できず、さらにデスクトップ版が起動のたびに作るランダムな合言葉が必要です。
• ページやランチャーを開く、ウィジェットを置く、エージェントのタスクを始めるときは、デスクトップ版に確認画面が出て、「許可」を押したときだけ進みます。「コマンドライン」→ 安全 で、開く系の要求と読み取りのみのエージェントタスクを信頼できます。ファイルを編集するタスクや「すべて自動で許可」は常に確認します。
• コマンドラインのプロセスはログイン情報やトークンを見られず、デスクトップ版がエージェントを実行するときにも渡しません。