imcodes
v2026.3.150
Published
A chat interface for AI coding agents — control Claude Code, Codex, Gemini CLI, OpenCode from browser and mobile
Downloads
9,082
Readme
IM.codes
A chat interface built for talking to AI coding agents. Not Slack, not Discord, not Telegram — something actually designed for the job.
Screenshots
Desktop
Mobile
Why
Every existing chat tool is built for humans talking to humans. When you're working with Claude Code, Codex, or Gemini CLI, you need terminal output, diff views, session management, multi-agent coordination — none of which fit into a 4096-char message box with emoji reactions.
I wanted a tool I could fully customize. Something that speaks the language of code, not social media. So I built one.
This is a personal project. I haven't written any code myself — it was built almost entirely by Claude Code, with significant contributions from Codex and Gemini CLI.
What it does
- Remote agent control — Talk to your agents from a browser or phone. No SSH, no VPN.
- Terminal + Chat modes — Switch between raw terminal (the native CLI experience) and a structured chat view.
- Multi-server, multi-session — Manage agents across machines from one dashboard.
- Real-time streaming — Live terminal output, no message limits, no rate throttling.
- Sub-sessions — Spawn additional agents from within a session. Run parallel tasks with full visibility.
- P2P multi-agent discussions — Route a topic through multiple agents in sequence. Each agent reads prior contributions and adds their own. Supports discuss, audit, review, and brainstorm modes. Works across Claude Code, Codex, and Gemini CLI — including sandboxed agents.
- File upload & download — Upload files from browser or phone (including camera). Files are relayed to the daemon and referenced in chat with
@path. Download project files directly from the built-in file browser. - Push notifications — Get notified on your phone when an agent needs attention.
- OTA updates — Daemon self-upgrades via npm. Trigger from the web UI for one device or all devices at once.
- Fully customizable — It's your UI. Add whatever you need — diff viewers, approval flows, custom scripts.
Architecture
You (browser / mobile)
↓ WebSocket
Server (self-hosted)
↓ WebSocket
Daemon (your machine, manages tmux)
↓ tmux
AI Agents (Claude Code / Codex / Gemini CLI / OpenCode)The daemon runs on your dev machine and manages agent sessions through tmux. The server relays connections between your devices and the daemon. Everything stays on your infrastructure.
Install
npm install -g imcodesQuick Start
Use the hosted version at app.im.codes, or self-host the server on your own infrastructure.
imcodes bind https://app.im.codes/bind/<api-key>This binds your machine, starts the daemon, and registers it as a system service.
Requirements
- macOS or Linux (tested on both). Windows users need WSL — native Windows is not supported since the project uses tmux to manage agent sessions.
- Node.js >= 20
- tmux
- At least one AI coding agent: Claude Code, Codex, Gemini CLI, or OpenCode
License
MIT
