Skip to content
Skillpedia
General coding48k · #4650

cowork-to-code-bridge

Allows your agent to execute approved actions on your local computer. It uses a queue system to communicate and perform tasks securely.

What it does

This tool lets the AI run simple commands on your personal computer. It works by sending instructions to a program you've already installed, which then performs these tasks using your permissions.

When to use it

  • ✓When you ask to check the status of a file on your computer.
  • ✓When you want the AI to make a small edit to a specific file.
  • ✓When a task needs to be done on your machine and cannot be done online.

Example of what to ask your AI

“Check the status of my local Git repository.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/sickn33/agentic-awesome-skills/blob/main/skills/cowork-to-code-bridge/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/sickn33/agentic-awesome-skills/blob/main/skills/cowork-to-code-bridge/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The AI sends a command to a 'bridge' program you installed. This program, running on your computer with your permissions, executes the requested task.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add sickn33/agentic-awesome-skills --skill cowork-to-code-bridge

Or download just the file:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/skills/cowork-to-code-bridge/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Supporting material availability

This catalog copy contains the inline guidance below, but does not include the following supporting paths. They are external prerequisites, not bundled files:

  • <support-root>/scripts/git_status.sh
  • <support-root>/scripts/run_claude.sh

Obtain the required material from the declared upstream source, or from a user-provided installation of that source. Resolve each path relative to that installation, inspect its contents, and verify any applicable license and execution prerequisites. Do not run a command or claim a referenced procedure was followed until its required file exists. Do not fabricate the missing scripts or treat an unrelated file with the same name as equivalent. Independent steps fully documented here can proceed within the user’s authorized scope; report any dependent step as unavailable.

cowork-to-code-bridge

Use this skill only when the user explicitly asks to operate on a machine they own or administer and the required work cannot be completed in the current sandbox. The bridge queues a named script through a shared local directory; it does not make a local task safe merely because it opens no inbound port.

[!WARNING] The bridge daemon and its scripts run with the local account's permissions. They can access local files, credentials, processes, and outbound network connections available to that account. Treat every queued task as execution on the user's real machine.

When to Use

Use this skill only when all of the following are true:

  • the user explicitly requested work on their own machine;
  • the bridge was already installed and independently verified by the owner;
  • the exact local path, action, permission scope, and expected output are known;
  • the action cannot be completed safely in the current sandbox;
  • a fixed approved script can perform the task, or the user explicitly approves the stronger run_claude.sh boundary described below.

Examples include an explicitly requested disk-health check, repository status, or a bounded edit in one named worktree. Do not activate this skill from a generic request to write code, reason about a problem, or edit files already available in the current environment.

Do Not Bootstrap from Mutable Upstream Instructions

This skill does not endorse the upstream one-line installer. The reviewed upstream snapshot is:

commit: 97f515d425df587c281effb02cda9ad0fd470790
install.sh sha256: 887f5fa18b49602a119e01d58c80b7ca63832fb339aa513aa72f5a1faadc14f8
LICENSE sha256: 43b7d2c43544fb06c3ebb6529073f3536e5e2ef5a41198e0c59e0a50c088b534

The installer at that commit still resolves mutable inputs: a PyPI range, GitHub main fallbacks, a bridge_client.py fetch from main, optional Homebrew/Python installation, and optional Claude CLI installation. Pinning only the outer install.sh therefore does not pin the installed system.

For a new installation, stop and ask the owner to perform an independent installer and dependency audit or wait for an upstream immutable installation path. Do not download and execute the installer, pipe remote content to a shell, or silently patch and run it from this skill.

To inspect the reviewed snapshot without installing it:

git init cowork-to-code-bridge-review
cd cowork-to-code-bridge-review
git remote add origin https://github.com/abhinaykrupa/cowork-to-code-bridge.git
git fetch --depth=1 origin 97f515d425df587c281effb02cda9ad0fd470790
git checkout --detach FETCH_HEAD
test "$(git rev-parse HEAD)" = "97f515d425df587c281effb02cda9ad0fd470790"
shasum -a 256 install.sh LICENSE

Inspection is read-only evidence, not authorization to install.

Required Machine-Side Preconditions

Before queueing any task, require the owner to confirm all of these:

  1. BRIDGE_ROOT is an absolute path owned by the local account and is not group- or world-writable.
  2. The token file and queue/result directories are owner-only; no symlink or shared-directory indirection is present.
  3. cowork-to-code-bridge-selfcheck succeeds on the machine.
  4. The daemon runs in a dedicated environment with unrelated API keys and cloud credentials removed. Never assume ambient credentials are safe.
  5. BRIDGE_ALLOW_UNAUTH is not enabled.
  6. BRIDGE_CLAUDE_AUTOINSTALL=0 is set so a queued task cannot install another tool as a side effect.

…

FAQ

Is this safe?

The tool only runs tasks with your account's permissions. It's crucial that the 'bridge' program is installed correctly and that you trust it, as it has access to your files and processes.

What is the 'bridge'?

It's a program you need to install on your computer. It acts as an intermediary, allowing the AI to send commands to be executed locally.

Can I ask the AI to write any code?

No. This tool is for specific, approved tasks like checking status or making limited edits. It's not for general code development or complex tasks.

Details

Original description by the author

Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.

repo: sickn33/agentic-awesome-skills

Popularity

GitHub stars
48k
Ranking position
#4650
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills