Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Tether is a desktop session multiplexer for Claude Code, Codex CLI, and OpenCode

## Tech Stack

- **Shell:** Electron 44 (sandboxed preloads; main owns PTY lifecycle, renderer owns UI)
- **Shell:** Electron 45 (sandboxed preloads; main owns PTY lifecycle, renderer owns UI)
- **Frontend:** React 19 + TypeScript
- **Terminal:** xterm.js 6.0 + xterm-addon-fit (same as VS Code)
- **Local PTY:** node-pty
Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@

## Download

Download the [latest stable Windows release](https://github.com/maxthomas95/tether/releases/latest). The v0.7.0 milestone brings together the changes tested on the 0.6.x beta train; see the [changelog](CHANGELOG.md) for the overview and upgrade notes. Beta builds remain on the [Releases page](https://github.com/maxthomas95/tether/releases).
Download the [latest stable Windows release](https://github.com/maxthomas95/tether/releases/latest). Beta builds, with the newest features ahead of the next stable release, are on the [Releases page](https://github.com/maxthomas95/tether/releases). See the [changelog](CHANGELOG.md) for what each release contains and any upgrade notes.

- **Setup installer** — `Tether-x.y.z-Setup.exe` (recommended)
- **Portable zip** — `Tether-x.y.z-portable.zip` (no install required)
Expand Down Expand Up @@ -67,7 +67,7 @@ Tether gives you a **single window** with a sidebar to manage it all — while e
- **Canvas layout** — arrange movable, resizable session panels, pan across larger workspaces, and retain their arrangement when switching layouts
- **Workspace recipes** — save named session groups and layouts, then reopen selected slots with edited paths or remapped environments; opening a recipe starts fresh sessions and leaves existing ones running
- **Navigation and visibility** — `Ctrl+P` session search, an attention queue, local repository branch/dirty badges, and terminal hover previews
- **Child-agent visibility** — Claude subagent rows for local, SSH, and Coder sessions, with status, model, timing, tokens, and a read-only transcript viewer. Trusted, opted-in local Codex lifecycle hooks also show `codex exec` runs launched by Claude
- **Child-agent visibility** — Claude subagent rows for local, SSH, and Coder sessions, with status, model, timing, tokens, and a read-only transcript panel docked beside the terminals. Trusted, opted-in local Codex lifecycle hooks also show `codex exec` runs launched by Claude
- **Desktop notifications** — configurable alerts for waiting, idle, unexpected exit, and terminal bell; per-session mute toggle with 🔕 badge; suppresses when focused
- **Status indicators** — green (running), amber (waiting), gray (idle), red (dead) — passive PTY tap, no ANSI parsing; optional CLI hook integration for higher-fidelity detection
- **Workspace persistence** — sessions save on quit and restore on launch; writes are atomic (tmp → fsync → rename)
Expand Down Expand Up @@ -107,12 +107,12 @@ Tether gives you a **single window** with a sidebar to manage it all — while e

- **Customizable keyboard shortcuts** — every binding remappable in Settings, with a reserved-chord warn list for conflicts like `Ctrl+C`
- **Window zoom** — `Ctrl+=` / `Ctrl+-` / `Ctrl+0` zoom UI + terminal together; `Ctrl+scroll` resizes just one pane's terminal font
- **Font customization** — pick terminal font (Cascadia Code, JetBrains Mono, Fira Code, Consolas) and UI font (IBM Plex Sans, Inter, Atkinson Hyperlegible, System) independently
- **Font customization** — pick terminal font (Cascadia Code, JetBrains Mono, Iosevka Fixed, IBM Plex Mono, Fira Code, Consolas) and UI font (IBM Plex Sans, Inter, Atkinson Hyperlegible, System) independently
- **Terminal search** — search each pane's scrollback with next/previous, match-case and whole-word options
- **Clickable URLs** — `Ctrl+click` HTTP(S) URLs and OSC 8 hyperlinks, including Claude login links, to open them in the system browser
- **Clipboard and multiline input** — bracketed paste, write-only OSC 52 for remote clipboard copying, and per-CLI Windows Shift+Enter handling; hold Shift while dragging to select text in mouse-capturing full-screen CLIs
- **In-app documentation** with `(?)` deep-link icons that jump from dialogs straight to the relevant docs section
- **Eleven themes** — Catppuccin (Mocha, Macchiato, Frappé, Latte), Brass, Tether (Default Dark), Tether Light, Nord, Gruvbox Dark/Light, Harbor — applied everywhere including the title bar and docs window; bundled Iosevka Fixed and IBM Plex Mono terminal fonts with a live specimen preview
- **Eleven built-in themes, plus your own** — Catppuccin (Mocha, Macchiato, Frappé, Latte), Brass, Tether (Default Dark), Tether Light, Nord, Gruvbox Dark/Light, Harbor — applied everywhere including the title bar and docs window, with a live terminal specimen preview; local theme packs load from Tether's themes folder

### Operations

Expand Down Expand Up @@ -156,7 +156,7 @@ Use `npm run test:coverage` to generate application coverage and a local HTML re

| | Technology | Why |
|---|---|---|
| Shell | Electron 44 | Native window management, sandboxed preloads, context isolation |
| Shell | Electron 45 | Native window management, sandboxed preloads, context isolation |
| Frontend | React 19 + TypeScript | Component model, ecosystem |
| Terminal | xterm.js 6.0 | Full VT emulation — same engine as VS Code |
| Local PTY | node-pty | Real pseudo-terminal, same lib as VS Code |
Expand Down
2 changes: 1 addition & 1 deletion ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ This milestone brings the 0.6.x beta train to stable. The [changelog](CHANGELOG.
- Investigate new status/attention regressions using live traces across CLI, transport, and hook settings. Cadence-only status remains an estimate, especially for quiet model calls or child agents.
- Keep event-day accounting, request/compaction deduplication, per-model/environment attribution, and unknown daily timing explicit in usage UI and exports.
- **Copilot cost tracking remains blocked:** there is no supported cost reader. Inspect an installed CLI's persisted usage format before proposing ingestion; resume and transcript browsing already work.
- OpenCode usage covers the supported local Crush database, not all OpenCode storage formats. Remote OpenCode usage and broader format coverage remain unimplemented.
- OpenCode usage covers the supported native local SQLite schema and legacy Crush snapshots, not every OpenCode storage format. Remote OpenCode usage, quota, and broader format coverage remain unimplemented.

### Release and desktop quality

Expand Down
2 changes: 1 addition & 1 deletion site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1241,7 +1241,7 @@ <h2 class="section-title">Built with</h2>
<div class="stack" style="margin-top: 32px;">
<div class="stack-item stagger">
<div class="stack-layer grad-text">Shell</div>
<div class="stack-name">Electron 44</div>
<div class="stack-name">Electron 45</div>
<div class="stack-note">Main process owns PTY lifecycle</div>
</div>
<div class="stack-item stagger">
Expand Down
6 changes: 3 additions & 3 deletions src/docs-renderer/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -56,12 +56,12 @@ const pages: DocPage[] = [
{ id: 'getting-started', title: 'Getting Started', html: renderMarkdown(gettingStartedMd) },
{ id: 'sessions', title: 'Sessions', html: renderMarkdown(sessionsMd) },
{ id: 'environments', title: 'Environments', html: renderMarkdown(environmentsMd) },
{ id: 'settings', title: 'Settings', html: renderMarkdown(settingsMd) },
{ id: 'keyboard-shortcuts', title: 'Keyboard Shortcuts', html: renderMarkdown(keyboardShortcutsMd) },
{ id: 'usage-quota', title: 'Usage & Quota', html: renderMarkdown(usageQuotaMd) },
{ id: 'vault', title: 'Vault', html: renderMarkdown(vaultMd) },
{ id: 'git-providers', title: 'Git Providers', html: renderMarkdown(gitProvidersMd) },
{ id: 'usage-quota', title: 'Usage & Quota', html: renderMarkdown(usageQuotaMd) },
{ id: 'helm', title: 'Helm', html: renderMarkdown(helmMd) },
{ id: 'keyboard-shortcuts', title: 'Keyboard Shortcuts', html: renderMarkdown(keyboardShortcutsMd) },
{ id: 'settings', title: 'Settings', html: renderMarkdown(settingsMd) },
];

let currentPage = pages[0];
Expand Down
25 changes: 16 additions & 9 deletions src/docs/sessions.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,5 @@
# Sessions

## Check and update a session's CLI

Choose **Check / update CLI…** from a Codex, Claude Code, or OpenCode session's menu.
The maintenance terminal uses that session's machine or Coder workspace and its
launch environment. Check the executable path and version before updating, and
choose the update method matching your installation. Existing conversations keep
running; restart or resume them when ready after an update. See **Settings → CLI
updates** for installation methods and cancellation behavior.

A **session** in Tether is a running CLI process in a specific directory and environment. You can have many sessions open at once, each with its own terminal. Tether is a "dumb pipe" — the PTY stream flows byte-for-byte into the terminal; nothing is parsed, rewritten, or intercepted.

The optional **[Pip sidebar pet](settings.md#pip-sidebar-pet)** follows the focused session, reacts to its status, and taps a tiny keyboard while you type. Enable it from **View → Pip Sidebar Pet**. Its **waiting** button opens another session that needs input, with permission prompts first. Optional AI quips and submitted-prompt sharing have separate controls in **Settings → Pip**, using your Codex or Claude sign-in.
Expand Down Expand Up @@ -182,6 +173,22 @@ Right-click a session and choose **Mute notifications** to silence desktop notif

If a session inside a split pane dies, the pane shows an in-pane overlay with **Restart in this pane** (re-spawn with the same working directory, environment, launch profile, session overrides, and known conversation, keeping the layout slot) or **Close pane**.

### Session details

The **⋯** button at the end of a pane's status strip opens **Session details**: the CLI, environment and project,
the model and reasoning effort requested at launch and those last observed, context window and last request size,
token, cache and cost totals with their cost basis, usage-tracking and hook health, active subagents, and the
session's native ID. Values Tether has not observed are shown as unknown rather than guessed. Press **Esc** or click
outside to close it.

### Checking and updating a session's CLI

Choose **Check / update CLI…** from a Codex, Claude Code, or OpenCode session's menu.
The maintenance terminal uses that session's machine or Coder workspace and its
launch environment. Check the executable path and version before updating, and
choose the update method matching your installation. Existing conversations keep
running; restart or resume them when ready after an update. See [CLI updates](settings.md#cli-updates) for installation methods and cancellation behavior.

## Broadcast Input

Broadcast input is available in split layouts. Entering Canvas clears broadcast targets; typing in Canvas goes to the focused terminal.
Expand Down
Loading
Loading