# tlive

> Self-hosted remote approvals for Claude Code and Codex: allow tool calls and follow runs from Telegram, Feishu or a web terminal.

tlive is a self-hosted layer that lets you watch and steer your Claude Code and Codex sessions from your phone. Your agent keeps running in your terminal as usual; tlive uses the agents' own hook and app-server mechanisms to push status and approval cards to Telegram or Feishu, and serves a web dashboard and a real terminal from your own machine. It works with any subscription or API key, and your sessions and data stay on your machine.

What you can do with it
- Get notified in Telegram, Feishu or a desktop toast when a run finishes, fails or is waiting for you
- Turn on remote approval (tlive mode full) to Allow, Deny or Always-allow a tool call from your phone, in parallel with the terminal dialog: whichever answers first wins
- Reply to an IM message to continue a stopped run, and answer the agent's questions from IM or the dashboard
- Wrap a session (tlive run claude) for a live web terminal you can type into from any device, and send it photos or files
- See every session on one dashboard, with its status and last message

How it connects
- Install the engine with npm install -g tlive, then run tlive setup. It registers the tlive plugin through Claude Code's and Codex's own plugin managers and asks for your IM bot credentials (or skip them and ask your agent to help configure tlive).
- The Claude Code plugin from this page adds tlive's hooks, a tlive skill and the /tlive:url and /tlive:status commands. It still needs the tlive engine installed to work.
- Codex sessions are watched through an app-server companion; Codex needs no hooks.

Good to know
- The default posture is notify: tlive watches and notifies but never holds a tool call. Remote approval is opt-in, and tlive mode off turns every hook off.
- Nothing is ever auto-denied: if no one answers remotely, your local prompt stays in charge, and your own permissions.deny settings always win.
- The dashboard binds to your LAN by default, guarded by a single token; set web.bind to 127.0.0.1 for loopback only. Cards never carry the dashboard link.
- /trust on and Always-allow auto-approve until the daemon restarts, so use them with care.
- Version 2 is a rewrite of the earlier bridge, with no migration. A community project by y49, MIT licensed.

- Type: Plugin
- Made by: y49
- Category: Communication
- Formats: Claude plugins
- Version: latest
- Website: https://github.com/y49/tlive
- Source: https://github.com/y49/tlive/tree/HEAD/plugins/claude/plugins/tlive
- Page: https://pluginboard.ai/plugins/tlive

## Works with

- Claude
- GitHub Copilot
- Claude Code
- OpenClaw

## Install

### Claude

In Claude (web or desktop): Customize → Plugins → Add → Add marketplace, enter y49/tlive, then add tlive

### Claude Code

In Claude Code:

```text
/plugin marketplace add y49/tlive
/plugin install tlive@tlive
```

---
From Pluginboard (https://pluginboard.ai).
