{"slug": "tend-one-local-page-for-all-your-claude-code-sessions", "title": "Tend. one local page for all your Claude Code sessions", "summary": "A developer tool called tend, distributed as the npm package tend-cc and run via `npx tend-cc`, puts every Claude Code session on one local web page by running each session as the real Claude Code TUI inside tmux and reading Claude Code's own hooks and status line. tend surfaces sessions waiting on a permission, question or plan, flags stuck, crashed or overlapping sessions, applies rule-based risk labels so high-risk requests are never one click or \"always allowed,\" and tracks context per session plus 5-hour and weekly usage per account. The tool requires macOS, Node.js 24+, tmux and a logged-in Claude Code, and lists sessions started outside tend as read-only, never stopping, signaling or typing into a session it did not start.", "body_md": "Run 5 or 25 Claude Code sessions and see them all in one place: what each one is doing, which ones need you,\n\nwhat they changed and what they cost. Only the things that need you interrupt you.\n\nRunning a handful of Claude Code sessions at once means a wall of terminals. One of them is waiting on a permission prompt. Another finished ten minutes ago. Two are editing the same file. You find out by tabbing through every window.\n\n**tend turns that wall into one page.** It doesn't wrap or replace Claude Code: every session is the real Claude Code\nTUI running in tmux. tend listens to Claude Code's own hooks and status line, and puts what matters on top.\n\n| **For you** lists the sessions waiting on a permission, a question or a plan, then problems (stuck, crashed, overlapping). Everything else stays quiet. | Permission, question and plan cards go through Claude Code's own hook. Allow, deny or add a note without opening the terminal. Answer in the terminal instead and the first answer wins. | \n| Rule-based risk labels on every request. **High-risk requests are never one click and never \"always allowed\".** | A **Terminal \\| Review** tab per session: file tree, unified or split diffs with word-level marks, rendered Markdown, line comments sent back to Claude as one review. | \n| A worktree per session, live git facts, overlap warnings when two sessions touch the same file, Pause/Resume that saves the work as one commit and restores it exactly. | Context per session and 5-hour / weekly usage per account, with a pace, read from Claude Code's own status line. Multiple accounts supported. | \n\n| <sub>**Decision cards.** Medium risk is one click (or `A`).</sub> | <sub>**High risk.** A force push asks you to confirm, every time.</sub> | \n| <sub>**Review.** Changed files, split diff, “Viewed” marks that reset when Claude edits again.</sub> | <sub>**⌘K.** Jump to any session or run any action.</sub> | \n\n## **Everything else it does**\n\n- **Briefing per session.** Goal, what got done, your instructions and files, built from its events. No AI tokens spent.\n- **Calm by default.** Focus windows batch everything except urgent items. Quiet hours, an hourly budget, Park\neverything, a daily wrap-up and \"since you left\".\n- **Stuck and crashed sessions** are flagged on their own.\n- **Elsewhere.** Claude sessions you started outside tend (another terminal, background agents) are listed\nread-only. Close one there with`/exit` and**Adopt** resumes the same conversation under tend, with cards,\nbriefing and review. tend never stops, signals or types into a session it didn't start.\n- **Media.** Paste or drop screenshots, images, PDFs and files. They become paths at the prompt.\n- **Polish.** Smart links, one tend per machine,`tend rotate-token` , and a self-test after Claude Code updates.\n\n```\nnpx tend-cc\n```\n\nThat's it. tend starts and opens in your browser. Click **New session**, pick a folder, and you're running Claude Code from one page.\n\nTo keep it around as a `tend` command:\n\n```\nnpm i -g tend-cc\ntend\n```\n\n**Needs** macOS (the core works on Linux, untested), Node.js 24+, [tmux](https://github.com/tmux/tmux) and [Claude Code](https://docs.anthropic.com/en/docs/claude-code) logged in. Missing something? `tend doctor` tells you exactly what and how to fix it:\n\n``` bash\n$ npx tend-cc doctor\n✓ Node.js 24+  v24.4.0\n✗ tmux         → brew install tmux\n✓ Claude Code  2.1.330 (Claude Code)\n✓ macOS        yes\n```\n\nSessions live in tmux, so they keep running if tend stops. Start it again and everything comes back.\n\n## Run from source\n\n```\ngit clone https://github.com/Geekgineer/tend.git && cd tend\nnpm install\nnode bin/tend.mjs\n```\n\n| Command | What it does | \n|---|---|\n| `tend` | Start and open the page. One per machine; a second one tells you where the first is running. | \n| `tend --no-open` | Start without opening the browser (also `TEND_NO_OPEN=1` ) | \n| `tend doctor` | Check Node, tmux and Claude Code, with the fix for anything missing | \n| `tend rotate-token` | A new link. Old links and open tabs stop working within a second. | \n| `TEND_PORT` ,`TEND_HOME` | Port (default 4977) and data folder (default `~/.tend` ) | \n\n``` php\nflowchart LR\n  B[\"Your browser<br/>one page\"] <-- \"SSE + token\" --> T[\"tend<br/>127.0.0.1:4977\"]\n  T <-- \"tmux control mode\" --> S1[\"claude · session 1\"]\n  T <-- \"tmux control mode\" --> S2[\"claude · session 2\"]\n  T <-- \"tmux control mode\" --> S3[\"claude · session N\"]\n  S1 & S2 & S3 -- \"hooks + status line\" --> T\n  T --- D[(\"~/.tend<br/>SQLite\")]\n```\n\n- Every session is the **real Claude Code TUI** in tmux, streamed to xterm.js in the browser.\n- tend writes a per-session settings file, so Claude Code reports to it through **its own hooks** (permissions,\nquestions, plans, tool use) and**its own status line** (context, usage).\n- State lives in `~/.tend` (SQLite). Node.js only: no native modules and five runtime dependencies.\n\n| 🔒 **Local only** | Binds to `127.0.0.1` . Every request needs the token (cookie or header), with Origin and Host checks. Only`/health` is open, and it carries no data. | \n| ✋ **You approve, always** | tend never approves anything you didn't, never passes `--dangerously-skip-permissions` , and never accepts Claude's trust dialog for you. | \n| 🙈 **Hands off your secrets** | tend never reads your Claude credentials and makes no network calls of its own. | \n| 📭 **No telemetry** | None. Everything lives in `~/.tend` . | \n\n| Keys | Action | \n|---|---|\n| `⌘`` K` | Palette: jump to a session or run an action | \n| `A` /`D` | Allow / deny the focused card | \n| `Ctrl``` ` `` | Switch Terminal ⇄ Review | \n| `j` /`k` | Next / previous file in Review | \n| `n` /`p` | Next / previous change | \n| `v` | Mark file viewed | \n| `⌘`` P` | Open any file | \n\n## **Does it replace Claude Code?**\n\nNo. Every session is Claude Code itself, unmodified, in tmux. You can attach to any session from a terminal and\nkeep working there.\n## **Does it cost tokens?**\n\nNo. Briefings, risk labels and summaries are built from Claude Code's events by plain rules. tend spends no AI tokens of its own.\n## **Linux? Windows?**\n\nThe core works on Linux, but the Finder folder window, notifications and image conversion don't, and Linux isn't\ntested. Windows isn't supported.\n## **Multiple Claude accounts?**\n\nYes. tend finds your Claude config folders and shows usage per account. Pick the account when you start a session.\n\n```\nbin/        the tend command\nsrc/        server: sessions, tmux, hooks, git, usage, risk, store\nui/         the page: plain ES modules, no build step\ntest/       unit, integration and e2e (a fake Claude, no tokens spent)\nscripts/    build and lint · smoke/ real-Claude runs · probe/ browser checks · perf/ load and soak\ndocs/       design spec, per-version results, research, README assets\nnpm test            # the full suite: fake Claude, no tokens spent\nnpm run typecheck\nnpm run check       # file size, dependency allowlist, syntax\n```\n\n| Script | What it checks | \n|---|---|\n| `scripts/probe/e2e-browser.mjs` | The full journey in headless Chrome (19 checks, fake Claude) | \n| `scripts/smoke/real.mjs` ,`decisions.mjs` ,`usage.mjs` ,`media.mjs` | Real Claude (haiku), throwaway temp repos | \n| `scripts/smoke/package.mjs` | Pack, install into an empty folder, run | \n| `scripts/smoke/selftest.mjs` | The Claude Code compatibility self-test (one tiny prompt) | \n| `scripts/perf/load.mjs` ,`soak.mjs` | 20 sessions under load; long soak runs | \n\nDesign: [`docs/design/2026-10-27-tend-design.md`](https://github.com/Geekgineer/tend/blob/main/docs/design/2026-10-27-tend-design.md). Per-version criteria and\nresults: [`docs/versions/`](https://github.com/Geekgineer/tend/blob/main/docs/versions). More in [` docs/`](https://github.com/Geekgineer/tend/blob/main/docs/README.md).\n\n<sub>Built for people who run more Claude Code sessions than they have monitors.</sub>", "url": "https://wpnews.pro/news/tend-one-local-page-for-all-your-claude-code-sessions", "canonical_source": "https://github.com/Geekgineer/tend", "published_at": "2026-11-22 17:28:24+00:00", "updated_at": "2026-11-22 17:42:26.961821+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools", "ai-tools", "ai-products"], "entities": ["tend", "tend-cc", "Claude Code", "Anthropic", "tmux", "Node.js", "Geekgineer"], "also_reported_by": [], "takeaway": "tend runs each Claude Code session as the real TUI in tmux and reads Claude Code's own hooks and status line to show pending permission, question and plan cards on one page, with high-risk requests requiring explicit confirmation every time.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/tend-one-local-page-for-all-your-claude-code-sessions", "markdown": "https://wpnews.pro/news/tend-one-local-page-for-all-your-claude-code-sessions.md", "text": "https://wpnews.pro/news/tend-one-local-page-for-all-your-claude-code-sessions.txt", "jsonld": "https://wpnews.pro/news/tend-one-local-page-for-all-your-claude-code-sessions.jsonld"}}