Lisovate

Lisovate / agent-ws

Public

WebSocket bridge for CLI AI agents. Stream responses from Claude Code and Codex CLI over WebSocket. A dumb pipe: no prompt engineering, no credential handling, just transport.

29
1
100% credibility
Found Feb 19, 2026 at 28 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A lightweight bridge that enables web applications to send prompts to local AI assistants like Claude Code or Codex and receive their streaming responses over a simple web connection.

How It Works

1
🔍 Discover the bridge

You find a simple tool called agent-ws that connects your web apps to smart AI helpers already on your computer for real-time chats.

2
📦 Prepare your AI helpers

Make sure you have AI assistants like Claude or Codex set up on your machine so they're ready to answer questions.

3
🚀 Launch the bridge

Start the bridge tool, which opens a private doorway on your computer for your apps to reach the AI.

4
🔗 Link your app

Connect your website or app to this local doorway, making it easy to talk to the AI from anywhere in your project.

5
💬 Send a question

Type a request like 'Help me design a button' into your app and watch it forward to the AI helper.

6
✨ See live responses

The AI's answers and thoughts stream back instantly, appearing piece by piece in your app for a magical feel.

🎉 Smart app alive!

Your project now delivers clever, on-demand AI help smoothly and securely from your own computer.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 28 to 29 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is agent-ws?

agent-ws is a TypeScript WebSocket bridge that connects any client to local Claude Code or Codex CLI tools, streaming prompts and responses in real-time over ws://localhost:9999. Fire off JSON messages with text, images, models, or system prompts; get back chunked output, including thinking steps, with support for multi-turn sessions via project IDs. It's a pure transport layer—no auth, no prompt tweaks, just stdio over WebSocket for browser apps, scripts, or services.

Why is it gaining traction?

Unlike full AI SDKs, agent-ws skips credential handling and cloud dependencies, letting you leverage battle-tested CLI agents like a kafka websocket bridge or ros websocket bridge but for AI. Devs dig the dead-simple protocol, image support up to 10MB, and per-connection isolation with timeouts and cancels. With npm install -g and npx agent-ws, it's instant for github websocket chat or live streaming in web UIs.

Who should use this?

Frontend devs building AI code assistants or image-describing tools in React/Next.js, needing local Claude/Codex without API wrappers. Backend teams embedding agent streams in Node.js Express/Fastify routes for real-time services. Fullstack prototypers wanting a foxglove websocket bridge-style pipe for github websocket client experiments.

Verdict

Solid for local prototypes—clean docs, TypeScript types, and MIT license—but at 29 stars and 1.0% credibility, it's early and unproven at scale. Grab it if you run CLIs already; skip for production without more battle tests.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.