tlive

Your claude / codex runs in your terminal as usual. tlive rides the open hook mechanism both vendors support to push status (and, when you turn it on, approval cards) to Telegram / Feishu, and serves a web dashboard + real terminal off your own machine — watch a run, reply to continue, send a screenshot, or take over typing, from any device. Works regardless of subscription or API key; your session and data never leave your machine.

Out of the box tlive watches and notifies (mode: notify, the safe default — it can never hold up a tool call). Flip on remote approval — hold each tool call so you can Allow/Deny it from your phone — with one command: tlive mode full (or let tlive setup offer it).

[!WARNING] v2.0 is a ground-up rewrite — breaking, with no migration. tlive is no longer the Agent-SDK IM bridge of v1.x and earlier: it no longer drives or owns your sessions, and the old bridge model, its config schema, and its commands (workspace, /use, chat-binding, …) are gone and unsupported. Don't try to carry an old ~/.tlive config forward — just run tlive setup fresh. The final SDK-bridge release is preserved at git tag v1.0-sdk-bridge.

Jump to: Quick start · Integration levels · Features · Install · Codex companion · Security · CLI · Config · Architecture

30 seconds to running

npm install -g tlive

tlive setup        # wizard: registers the tlive plugin with Claude Code's/
                    # Codex's own plugin manager (hooks, skill, /tlive:*
                    # commands), then IM credentials — or skip IM entirely
                    # and say "help me configure tlive" inside Claude/Codex
tlive start        # daemon up — prints web URLs + a QR code for your phone

tlive run claude   # (optional) wrap the session → live web terminal + preview card

Scan the QR once — the dashboard lists every session and streams each run. Turn on remote approval (tlive mode full) and, when a tool call needs approval, your IM gets a card with Allow / Deny / Always-allow buttons and the web card lights up red.

The two integration levels

	hooks/companion only (claude/codex as usual)	wrapped (tlive run claude/codex)
Approval cards (IM + web)	✅	✅
Stop-resume by IM reply	✅ (reply window)	✅
Session card on dashboard	✅ status / last message	✅ + live terminal preview
Real web terminal (xterm)	—	✅ multi-device, phone keys
IM text injection (quote-reply → typed into the pty)	—	✅
IM photo/file → agent	—	✅ (downloaded, path injected)
Web paste/drop upload	—	✅

Hooks-only always works — wrapping is pure addition. The Approval cards row needs remote approval on (tlive mode full); the default notify mode does everything else — live monitoring, turn-finished / waiting notifications, reply-to-continue, the web terminal — without ever holding a tool call. IM messages carry a label · prefix (the session's directory) but no longer mark wrapped vs. hooks-only visually — the continue card's own "Reply to continue" line makes the distinction moot for what you actually do.

What's in the box