IM.codes

The IM for agents

imcodes bind https://app.im.codes/bind/<key>

bound to app.im.codes · daemon started · registered as system service

Self-hosting is strongly recommended. app.im.codes is a shared test instance with no uptime guarantees — it may be rate-limited, targeted, or unavailable. This is a personal project with no commercial support. For anything beyond evaluation, deploy on your own infrastructure.

screenshots

Desktop

iPad / Tablet

Mobile

why

Since 2026, developers talk to agents. Agents write code, run tools, and manage workflows. But generic chat apps were never built for this. IM.codes is a dedicated messaging layer for AI agents: remote terminals that work like SSH without the SSH, a chat view that understands agent output, and multi-agent workflows that let you coordinate different models on the same task.

features

remote terminal

browser & mobile, no SSH/VPN, real-time PTY streaming at 12fps

terminal + chat

raw CLI or structured view with parsed tool calls

OpenClaw support

chat with OpenClaw agents — plus terminal, files, and git that OC alone doesn't offer

Discord-style sidebar

server icons, session tree, unread badges, idle flash

multi-agent discussions

discuss, audit, review across providers with ring progress

@ picker

@files, @@agents, @@all(config) for group dispatch

multi-server

manage agents across machines from one dashboard

pinnable panels

drag any window to sidebar, cross-device sync

sub-sessions

spawn parallel agents on the fly

file browser & git

tree view, upload/download, +/- stats, floating preview

repository dashboard

issues, PRs, branches, commits, CI/CD

scheduled tasks

cron-style automation, timezone-aware, execution history with jump-to-session

local web preview

preview localhost from any device via secure tunnel, supports HMR

cross-device sync

tab order, pinned tabs & panels synced to server

mobile & notifications

biometric auth, push notifications, shell keyboard input

7 languages

EN, 中文, 繁體, ES, RU, JA, KO

real-time stream

live output, zero polling, zero message limits

self-hosted

your infra, your data, one-command deploy

OTA updates

upgrade daemons from the web UI

architecture

You (browser / mobile) │ WebSocket Server (self-hosted, relays connections) │ WebSocket Daemon (your machine, manages sessions) │ tmux Agents (Claude Code / Codex / Gemini CLI / OpenClaw and more)

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.

download

Also available as a web app

install

$ npm install -g imcodes

click to copy

quick start

Use app.im.codes or self-host the server
Run imcodes bind https://app.im.codes/bind/<key>
Open the dashboard — your agents are live

self-host

Deploy server + daemon on a single machine. Requires Docker and a domain with DNS pointing to the server.

npm install -g imcodes
mkdir imcodes && cd imcodes
imcodes setup --domain imc.example.com

Generates all config, starts PostgreSQL + server + Caddy with automatic HTTPS, creates admin account, and binds the local daemon. Credentials printed at the end.

To connect additional machines:

npm install -g imcodes
imcodes bind https://imc.example.com/bind/<api-key>

Manual setup:

git clone https://github.com/im4codes/imcodes.git && cd imcodes
./gen-env.sh imc.example.com # generates .env, prints admin password
docker compose up -d

supported agents

Claude Code Codex Gemini CLI OpenClaw Shell + more

requirements

macOS or Linux (WSL on Windows)
Node.js ≥ 20
tmux

about

Personal project. Built almost entirely by Claude Code, with contributions from Codex and Gemini CLI.