@shubh_prajapati99/soupz
v0.2.0
Published
Code from anywhere — AI coding IDE that bridges your phone to your laptop
Maintainers
Readme
Soupz
Control your laptop's AI coding tools from any device. Run npx @shubh_prajapati99/soupz, scan a code, and code from your phone.
Soupz is a local-first AI agent orchestration daemon with a hosted web IDE. It bridges your laptop's AI coding agents (Claude Code, Gemini, Copilot, Ollama, Kiro) to any browser — phone, tablet, or another PC.
Quick Start
1. Install
npx @shubh_prajapati99/soupz2. Pair
Open your browser to https://soupz.vercel.app/code. Scan the QR code from your terminal, or enter the 9-character pairing code.
3. Build
- Chat Mode: Send prompts to your AI agents, get real-time responses
- IDE Mode: Edit files, run git commands, use a terminal — all from your phone
- Builder Mode: Lovable-style centered prompt with live preview split
Features
- Multi-Agent Orchestration — Automatically picks the best available agent (Claude Code, Gemini, Copilot, Ollama)
- Real-Time IDE — Monaco editor, file tree, git operations, terminal
- Local-First — Your code never leaves your machine. Web app is just a remote control.
- Mobile-Ready — Works on phones, tablets, any browser. True responsive design.
- Voice Support — Chat with voice input and neural text-to-speech
- Run Archive — Each order drops JSON/MD logs into
.soupz/output/so you can review prompts, plans, stdout, and events later - Free to Use — Works with free agents (Copilot, Gemini). No subscriptions required.
Architecture
- Daemon — Runs on your laptop (
npx @shubh_prajapati99/soupz), spawns CLI agents, manages files/git - Web App — Hosted at soupz.vercel.app, acts as a remote control
- Relay — Supabase Realtime for remote connections (LAN uses WebSocket)
- Pairing — 9-character OTP or QR code, 5-min auto-refresh
Requirements
- Node.js 18+
- At least one CLI agent installed:
- Claude Code (
npm install -g @anthropic-ai/claude-code) - Gemini CLI (
npm install -g @google/gemini-cli) - GitHub Copilot CLI (
gh copilot --version) - Ollama (
ollama pull <model>)
- Claude Code (
Documentation
- Setup & Troubleshooting
- System Architecture
- Runtime Changelog
- Project Overview
- Model Selection and Grading
- Owner Action Checklist
License
MIT
