Linco Bridge

An open bridge layer that connects AI Agent tools running on a personal computer to web, H5, mini program, app, IM, and custom clients.

Status: Open Source Alpha. Interfaces and compatibility may change with documented migration notes.

iOS App · Android App · Hosted Demo · Watch Demo · Quick Start · 简体中文

✨ Highlights

🧭 Overview

Linco Bridge connects local Agent CLIs to remote clients without moving Agent execution away from the user's computer.

Local Agent CLI
    ↕ local process, gateway, or session files
linco-connect on the user's computer
    ↕ authenticated WebSocket bridge
Official Linco channel, open reference platform, or custom backend
    ↕
Linco App, Reference Web, or custom client

The repository does not include the complete Linco App or the official hosted cloud-service implementation.

🚀 Choose a Path

1. Linco App

Download Linco App:

• iOS TestFlight
• Android APK

Open Bridge, choose an Agent import path, and run the generated commands on the computer where the Agent CLI is installed. A typical command shape is:

npm install -g linco-connect
linco-connect init --token "<app-id>:<app-secret>" --agent codex
linco-connect start --daemon

Return to the app, confirm the connector is online, and send a test message.

2. Open Reference Platform

Start the backend:

cd linco-bridge-platform/server
npm install
npm run start:dev

Start the H5 frontend in another terminal:

cd linco-bridge-platform/web
npm install
npm run dev:h5

Open the printed H5 URL, then:

1. Open Bridge and select Import from Codex.
2. Copy the generated setupCommands and run them locally.
3. Return to the page and refresh the connection status.
4. Enter Codex, select a project or session from the folder menu, and send a test message.

The generated commands are the source of truth. A local command usually has this shape:

linco-connect init \
  --token "<app-id>:<app-secret>" \
  --agent codex \
  --channel linco-demo \
  --account "<account-id>" \
  --allow-insecure-ws

linco-connect start --daemon

See Quick Start and the Platform README for the complete local flow.

3. Hosted Demo

• H5: https://bridge-demo.lincotalk.com
• WeChat Mini Program: search agent桥接器 or scan the QR code below.

Open Bridge, import an Agent, run the generated setupCommands on your computer, confirm the connector is online, and enter the chat page.

The hosted demo uses signed anonymous visitor sessions. It does not provide a formal account, durable cross-device recovery, or production-grade multi-tenant guarantees. Do not enter sensitive or production data. Custom frontends must self-host the platform instead of calling the official demo API.

🤖 Compatibility

Use Node.js 20 or 22–26; Node.js 22 LTS is recommended. See Supported Platforms for the current compatibility boundary.

🧩 Extension Points

Third-party integrations should add a custom channel adapter rather than changing the official linco channel. See Secondary Development Rules.

🔐 Security

• Never commit or log tokens, App Secrets, private keys, user data, or authenticated URLs.
• Use ws:// only for trusted local development. Public deployments should use HTTPS/WSS and define their own authentication, storage, audit, and retention policies.
• TLS/WSS does not by itself provide end-to-end encryption.
• File delivery must keep hidden and sensitive paths blocked.
• Read Security and Privacy before connecting real data. Report vulnerabilities through SECURITY.md.

📚 Documentation

💬 Community

Join the WeChat technical group for integration questions, product feedback, and Agent workflow discussions:

Follow Linco Lab for project updates and implementation notes:

• Xiaohongshu
• WeChat Official Account: search Linco Lab

WeChat QR codes may expire. See Community for the latest entries and support guidance.

🤝 Contributing

Issues and pull requests are welcome. Read CONTRIBUTING.md before proposing protocol, cross-module, or breaking changes.

⚖️ License

Linco Bridge is licensed under the MIT License. The license applies to repository code and documentation; it does not grant separate rights to use Linco names, logos, or other brand assets beyond normal nominative reference.