# Hotline Switchboard

> Live read-only HTML dashboard of hotline conversations — 'open/stop the switchboard', 'watch the hotline calls', 'is the switchboard running?

- **Type:** Skill
- **Install:** `agentstack add skill-jtsternberg-claude-plugins-switchboard`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jtsternberg](https://agentstack.voostack.com/s/jtsternberg)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jtsternberg](https://github.com/jtsternberg)
- **Source:** https://github.com/jtsternberg/claude-plugins/tree/main/plugins/hotline/skills/switchboard

## Install

```sh
agentstack add skill-jtsternberg-claude-plugins-switchboard
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Hotline: Switchboard

A local dashboard that shows every hotline call — who dialed whom, live/recent/stale status — and renders both ends of a call side-by-side, updating in real time as the conversations evolve. Strictly view-only: it tails the Claude Code transcript files, never writes.

## How it works

- Call registry: `~/.agents-hotline/sessions/*.json` (caller, callees, session IDs, modes).
- Discovery scan: calls missing from the registry are reconstructed from the `/hotline:hotline-ringing` handshake in each callee transcript's head and shown with a `traced` stamp.
- Transcripts: each session ID maps to `~/.claude/projects/*/.jsonl`, which Claude Code appends to live. The server tails these from byte offsets and streams new entries to the browser over SSE.
- Zero dependencies: single-file Node server, inline HTML/JS UI, no build step.

## Commands

All via one script:

```bash
# Codex: this path resolves under Claude Code; substitute the directory containing this SKILL.md.
SKILL_DIR="${CLAUDE_SKILL_DIR}"
bash "$SKILL_DIR/scripts/switchboard.sh" start [--port=4160] [--no-open]
bash "$SKILL_DIR/scripts/switchboard.sh" stop
bash "$SKILL_DIR/scripts/switchboard.sh" status
```

Each prints a JSON status line. `start` backgrounds the server (pidfile at `~/.agents-hotline/switchboard.pid`, log at `~/.agents-hotline/switchboard.log`) and opens the browser unless `--no-open` is passed. `start` always replaces any prior switchboard instance on the port (pidfile-tracked or ad-hoc) so it serves fresh code — it doubles as a restart.

## Usage

- **"Open the switchboard" / "watch the calls"** → run `start`, then report the `url` from the JSON output.
- **"Stop the switchboard"** → run `stop`.
- **"Is the switchboard running?"** → run `status`.
- Custom port: pass `--port=` or set `HOTLINE_SWITCHBOARD_PORT`.

## Notes

- Requires Node.js (`node` on PATH). If missing, `start` reports an error — tell the user to install Node.
- The board groups calls into **live** (activity in the last 15 min), **recent** (< 24h, tune with `--stale-hours` on the server), and **stale**.
- If a session's transcript can't be found (deleted, or the session was compacted into a new ID), the lane shows "No transcript found" — this is expected for old registry entries, not a bug.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jtsternberg](https://github.com/jtsternberg)
- **Source:** [jtsternberg/claude-plugins](https://github.com/jtsternberg/claude-plugins)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jtsternberg-claude-plugins-switchboard
- Seller: https://agentstack.voostack.com/s/jtsternberg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.