convez.ai
PluginDevOps & InfraestruturaIntermediário
AceDataCloud

Coding Bridge Agent

AceDataCloud/CodingBridgeAgent

Execute Claude Code remotamente com segurança mantendo tudo local

Ver no GitHub
InicialPluginScore · de 0 a 100

Daemon Python que executa Claude Code ou OpenAI Codex localmente na sua máquina, permitindo controle remoto via web sem expor sua máquina à internet. Conecta-se a um relay seguro, mantendo toda execução de código, acesso a arquivos e permissões localmente.

Instalação

$npx convez-ai AceDataCloud/CodingBridgeAgent

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 1 mês
Versão
v2026.10.4.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Executar tarefas de código automatizadas desde o navegador ou celular
  • Usar Claude Code com seus repositórios e servidores MCP privados
  • Controlar execução remota de scripts sem expor a máquina à internet

Veredito

Solução técnica bem pensada para quem quer potência de Claude Code com conveniência remota, mantendo o perímetro de segurança intacto. Requer Python 3.10+ e configuração prévia de Claude Code, adequado para desenvolvedores experientes.

README

A tradução para o português deste README ainda está na fila.

Coding Bridge Agent

Run Claude Code or OpenAI Codex on your own machine and drive it from the AceDataCloud web app (Nexior) or your phone — without exposing your machine to the internet.

The agent is a small, outbound-only daemon. It connects to the coding-bridge relay, registers your machine as a node, and runs local Claude Code or Codex sessions on your behalf. Code execution, file access, and tool permissions all stay local. The bridge only relays JSON messages between your browser and this daemon; it never sees your files and never runs anything.

┌────────────┐   wss (Ace JWT)   ┌───────────────┐   wss (node token)   ┌──────────────────────┐
│  Browser   │ ───────────────►  │ coding-bridge │ ───────────────────► │  coding-bridge-agent │
│ (Nexior)   │ ◄───────────────  │    (relay)    │ ◄─────────────────── │  (this daemon)       │
└────────────┘                   └───────────────┘                      │   └─ Claude Code     │
                                                                        └──────────────────────┘
                                                                              runs on YOUR machine

Why

You want the power of Claude Code (your repo, your shell, your MCP servers) but the convenience of kicking off and steering tasks from a browser or phone while away from your desk. This daemon makes that possible while keeping the trust boundary where it belongs: on your hardware. Every tool the agent wants to run is surfaced to your browser as an approval prompt that you allow or deny.

Install

Requires Python 3.10+ and a working Claude Code installation (the agent uses claude-agent-sdk, which drives your local Claude Code CLI and authentication).

To use the Codex provider, also install the Codex CLI and sign in (codex login). Codex sessions run via codex exec, so the session permission mode maps to a Codex sandbox policy (plan → read-only, default/acceptEdits → workspace-write, bypassPermissions → danger-full-access).

pipx install coding-bridge-agent      # recommended
# or
pip install coding-bridge-agent

For the ASCII-QR pairing helper, install the optional extra:

pipx install "coding-bridge-agent[qr]"

Quick start

coding-bridge-agent up

On first run this pairs your machine: it prints a short pair code (and a QR code). Open the link in Nexior, sign in with your Ace account, and enter the code. Once claimed, the daemon stores a node token at ~/.ace-bridge/credentials.json (mode 0600) and starts serving sessions.

Subsequent runs reuse the stored token, so coding-bridge-agent up just connects.

Commands

CommandWhat it does
upPair if needed, then run (default if no command given)
pairPair this machine and exit
runRun using stored credentials (errors if not paired)
statusShow configuration and whether this machine is paired
logoutRemove stored credentials

Run flags (up / run):

FlagPurpose
--modelDefault Claude model for new sessions
--cwdDefault working directory for new sessions
--permission-timeoutSeconds to wait for a permission decision (0 = wait)

Global flags: --bridge-url, --name, --config-dir.

Configuration

All settings can come from the environment (see .env.example):

VariableDefaultMeaning
CODING_BRIDGE_URLhttps://coding-bridge.acedata.cloudRelay base URL
CODING_BRIDGE_NODE_NAMEhostnameDisplay name for this node
CODING_BRIDGE_CONFIG_DIR~/.ace-bridgeCredential storage directory
CODING_BRIDGE_HEARTBEAT_INTERVAL15Heartbeat seconds
CODING_BRIDGE_PERMISSION_TIMEOUT300Permission wait seconds (0 = forever)
CODING_BRIDGE_MODEL—Default model
CODING_BRIDGE_CLAIM_URLhttps://studio.acedata.cloud/coding-bridge?code={code}Pairing claim link template

CLI flags override environment values.

Security model

  • Execution is local. The bridge is a dumb relay. Your code, files, and shell only ever touch this machine.
  • Outbound only. The daemon makes a single outbound WebSocket connection. It opens no listening ports.
  • Per-tool approval. Each tool the agent wants to use is relayed to your browser as a permission request. Nothing runs until you allow it; a configurable timeout denies by default.
  • Scoped token. Pairing yields a node token tied to your Ace account, stored locally with 0600 permissions. coding-bridge-agent logout removes it; the bridge can revoke it server-side.
  • Directory browser & images stay local. The fs.list action lets the paired browser list directories to pick a working directory, and pasted images are decoded to <cwd>/.tmp/images/. Both run within the OS permissions of the account running the daemon — the same local trust boundary as a session.
  • Your Claude auth stays put. The agent uses your existing local Claude Code authentication via claude-agent-sdk.

How it fits together

  • coding-bridge — the stateful relay (one component of the AceDataCloud platform) that authenticates browsers (Ace JWT) and nodes (node token), and forwards messages between them.
  • coding-bridge-agent (this repo) — the node daemon you run locally.
  • Nexior — the web/mobile UI that pairs nodes and renders sessions.

The node is the source of truth for the options the UI offers: it answers capabilities.get with the providers it supports and each one's models, effort tiers, and permission modes (see capabilities.py). The browser renders whatever the node reports, so adding a model is a node-side change — never a web rebuild.

The wire protocol (envelope types, the inner Action/Event sub-protocol) is documented in coding_bridge_agent/protocol.py.

Development

pip install -e ".[dev]"
ruff check .
pytest -q

Attribution & license

This project is licensed under AGPL-3.0-or-later (see LICENSE).

The remote permission-relay design — forwarding a coding agent's tool-approval decision to a remote approver — was inspired by VibeBridge (GPL-3.0). This is an independent implementation built on the public claude-agent-sdk; no VibeBridge source code is included. See NOTICE.

Ver o original no GitHub

Bom para

Relacionados