agentic-factory-bridge

Local bridge that connects the Atos Agentic Factory marketplace to OpenCode CLI on your machine.

What it does

• Detects whether OpenCode CLI is installed on your machine
• Registers the opencode:// custom protocol so the marketplace can launch OpenCode directly from the browser
• Runs a lightweight local server (port 3001) that the marketplace web UI communicates with

Requirements

• Node.js 18+
• Windows (protocol registration uses PowerShell and Windows Registry)
• OpenCode CLI installed globally: npm install -g opencode-ai

Installation

npm install -g agentic-factory-bridge

Usage

1. Initial setup (once)

Register the opencode:// protocol and verify OpenCode CLI is installed:

agentic-factory-bridge setup

2. Start the bridge

agentic-factory-bridge start

The bridge starts on http://localhost:3001. Keep this terminal open while using the marketplace.

3. Use the marketplace

Go to Atos Agentic Factory, navigate to any agent profile, and click "Open with OpenCode".

Commands

| Command | Description | | ---------------------------------- | -------------------------------------------------------- | | agentic-factory-bridge start | Start the local bridge server | | agentic-factory-bridge setup | Register the opencode:// protocol + install OpenCode CLI | | agentic-factory-bridge uninstall | Remove the opencode:// protocol from Windows Registry | | agentic-factory-bridge status | Check bridge, OpenCode CLI, and protocol status | | agentic-factory-bridge --version | Show version | | agentic-factory-bridge --help | Show help |

How it works

Browser (marketplace)  -->  localhost:3001 (bridge)  -->  OpenCode CLI
                                                     -->  Windows Registry (protocol)

1. The marketplace web UI calls http://localhost:3001 to detect if the bridge is running
2. The bridge checks if OpenCode CLI is installed and reports status back
3. When you click "Open with OpenCode", the browser navigates to opencode://run?agent=...
4. Windows routes the opencode:// protocol to the handler, which launches OpenCode CLI

Uninstall

agentic-factory-bridge uninstall   # Remove protocol registration
npm uninstall -g agentic-factory-bridge

License

MIT