jpskill.com
💬 コミュニケーション コミュニティ

background-computer-use

Launch and use the local BackgroundComputerUse macOS runtime through its self-documenting loopback API. Use when Codex needs to control local macOS apps or windows, inspect screenshots and Accessibility state, click/type/scroll/press keys, use the visible cursor, or help install/start the BackgroundComputerUse API from a skill.

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o background-computer-use.zip https://jpskill.com/download/9290.zip && unzip -o background-computer-use.zip && rm background-computer-use.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/9290.zip -OutFile "$d\background-computer-use.zip"; Expand-Archive "$d\background-computer-use.zip" -DestinationPath $d -Force; ri "$d\background-computer-use.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して background-computer-use.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → background-computer-use フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1
📖 Claude が読む原文 SKILL.md(中身を展開)

この本文は AI(Claude)が読むための原文(英語または中国語)です。日本語訳は順次追加中。

Background Computer Use

Use this skill to start or connect to the local macOS BackgroundComputerUse runtime, then rely on the runtime's own documentation endpoints instead of memorizing route schemas.

Workflow

  1. Start or discover the runtime:

    bash "$SKILL_DIR/scripts/ensure-runtime.sh"

    If $SKILL_DIR is not already set by the host, derive it from this skill folder path before running scripts.

  2. Read the runtime manifest from:

    $TMPDIR/background-computer-use/runtime-manifest.json

    Never assume a fixed port.

  3. Call GET /v1/bootstrap.

    • If instructions.ready is false, report the returned permission steps to the user.
    • Do not continue with actions until Accessibility and Screen Recording are ready.

  4. Call GET /v1/routes.

    • Treat this as the source of truth for available routes, request fields, response fields, examples, and error codes.
    • Do not assume browser routes exist; use them only when /v1/routes advertises them.

  5. For visual tasks, request screenshots with imageMode: "path" and inspect the returned image files when useful.

  6. For action routes, reuse stateToken from the state you inspected. Reuse the same cursor.id when the user wants one continuous visible cursor.

Helpers

  • scripts/ensure-runtime.sh: find, install, launch, and bootstrap the runtime.
  • scripts/install-runtime.sh: install BackgroundComputerUse.app from an app zip or release URL.
  • scripts/bcu-request.py: call runtime endpoints from the manifest base URL.

Examples:

python3 "$SKILL_DIR/scripts/bcu-request.py" GET /v1/bootstrap
python3 "$SKILL_DIR/scripts/bcu-request.py" GET /v1/routes
python3 "$SKILL_DIR/scripts/bcu-request.py" POST /v1/list_apps '{}'

Local Development

When working from a source checkout instead of an installed release:

BCU_SOURCE_DIR=/path/to/background-computer-use bash "$SKILL_DIR/scripts/ensure-runtime.sh"

That runs the repo's script/start.sh, which builds, signs, installs, launches, and bootstraps the app.

More Detail

Read references/runtime.md only when you need install modes, release packaging notes, or the permission/debugging checklist.