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
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,7 @@ Tether gives you a **single window** with a sidebar to manage it all — while e
- **Update notifications** — checks GitHub Releases on launch and links to downloads; stable/beta channels and an opt-out live in Settings → General
- **Diagnostics export** — one-click bundle of scrubbed `data.json` (SSH passwords, tokens, sensitive env-var values redacted) plus rotated logs, for triaging support issues
- **CLI maintenance** — check and update installed Claude Code, Codex CLI, and OpenCode tools on local, SSH, or Coder targets through temporary terminals
- **Optional sidebar companions** — local GIF panel and Pip pet, off by default. Pip's local reactions use status metadata; generated Codex quips and submitted-prompt sharing have separate opt-ins
- **Optional sidebar companions** — local GIF panel and Pip pet, off by default. Pip's local reactions use status metadata; generated Codex or Claude quips and submitted-prompt sharing have separate opt-ins
- **J.O.B.S. Office** — optional external office view, off for new setups, with separate connection, remote-session sharing and automatic-launch controls
- **Helm** *(opt-in, personal-experimental)* — designate a session as "helm" so it can dispatch pre-briefed child sessions through the `tether-helm` MCP, including spawning Coder workspaces. Off by default behind a two-level gate. Not on the 1.0 roadmap.

Expand Down Expand Up @@ -181,7 +181,7 @@ Tether runs as a desktop client; outbound network traffic is intentionally minim
| Configured Git provider and clone hosts | Repository browsing, creation, and cloning through GitHub, Azure DevOps, or Gitea. | `src/main/git/` |
| Configured webhook endpoint | Optional session-state notifications. A blank URL disables them. | `src/main/notifications/` |
| Configured J.O.B.S. server (default `localhost:8780`) | Opted-in health probes, Office view, and separately enabled remote-session narration. | `src/main/jobs/` |
| Provider endpoints used by the local Codex CLI | Optional Pip AI quips; submitted-prompt excerpts require separate consent. | `src/main/pip/`, `src/main/codex/pip-comment-client.ts` |
| Provider endpoints used by the local Codex CLI or Claude Code, whichever you choose | Optional Pip AI quips; submitted-prompt excerpts require separate consent for the chosen backend. | `src/main/pip/`, `src/main/codex/pip-comment-client.ts`, `src/main/claude/pip-comment-client.ts` |

Launch update checks, pricing refresh, and subscription quota are on by default. Disable launch checks in **Settings → General** and quota in **Usage**. Pricing refresh has no toggle and falls back to the bundled snapshot when unavailable. J.O.B.S. is off for new setups; saved integrations keep their previous behavior. Webhooks, Helm, GIFs, Pip, AI quips and prompt sharing require configuration or opt-in. Manual update checks and configured GitHub providers can still contact GitHub when launch checks are off. Each CLI also makes its own network requests.

Expand Down
2 changes: 1 addition & 1 deletion docs/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,7 @@ When sharing is enabled, remote SSH/Coder session metadata is narrated through J

The GIF panel reads only selected local image folders and ships no media. Pip's local reactions use session/focus metadata and a text-free typing signal. Both are off by default and pause hidden work/reduce motion as documented in [Settings](../src/docs/settings.md#appearance).

Pip AI comments are another opt-in, using a bounded temporary Codex conversation with ChatGPT sign-in. Activity-only context excludes paths, labels, draft text, and terminal output. Separate prompt-sharing consent permits a scrubbed, bounded excerpt from an attributed recent local Claude/Codex transcript. Tether saves neither excerpts nor generated comments. Failure or unavailable models fall back to local quips.
Pip AI comments are another opt-in. The user picks a backend behind `PipCommentBackend` (`src/main/pip/backends/`): a bounded temporary Codex conversation with ChatGPT sign-in, or a one-shot Claude Code Haiku prompt with subscription sign-in, no tools, no settings sources (so no hooks), and no saved session. Main owns the cooldown and hourly cap. Activity-only context excludes paths, labels, draft text, and terminal output. Separate prompt-sharing consent permits a scrubbed, bounded excerpt from an attributed recent local Claude/Codex transcript. Tether saves neither excerpts nor generated comments. Failure or unavailable models fall back to local quips.

## Desktop Security and Packaging

Expand Down
2 changes: 1 addition & 1 deletion src/docs/sessions.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ 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 switches in Pip's **Personality & comments** controls.
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 **Pip options**, using your Codex or Claude sign-in.

## Creating Sessions

Expand Down
13 changes: 7 additions & 6 deletions src/docs/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -180,24 +180,25 @@ Choose **View → Pip Sidebar Pet** to invite Pip into the sidebar. Pip is a sma
- When a turn Pip watched from its start runs five minutes or longer, the ready reaction mentions how long it took. Pip also notices when the focused Claude or Codex session starts its first subagent or `codex exec` run; this follows **Show subagents in sidebar**, and OpenCode sessions have no child rows to notice.
- When another session is waiting, the **waiting** button switches to it, prioritizing permission prompts. The button stays in the header while the panel is collapsed. While any session is blocked on a permission prompt, Pip stays alert until it is answered. Switching sessions quickly can make Pip dizzy. Click Pip, or focus it and press **Enter** or **Space**, to pet it.
- Pip perks up and taps a tiny keyboard while you type in the focused terminal. Pressing **Enter** gets an occasional reaction; this signals a keypress, not proof that the CLI accepted a prompt. Keys, pasted text, and composed text count as typing; focus changes, mouse movement, and the terminal's own replies do not. Draft text is never collected for this animation.
- **Quiet** keeps the expressions and silences local and AI comments. **Personality & comments** lets you choose **Dry little gremlin** or **Cozy companion**, and turn ambient motion off. Your system's reduced-motion preference also stops animations and cursor tracking.
- **Quiet** keeps the expressions and silences local and AI comments. **Pip options** lets you choose **Dry little gremlin** or **Cozy companion**, and turn ambient motion off. Your system's reduced-motion preference also stops animations and cursor tracking.
- Routine comments appear at most once every 25 seconds. A session becoming ready or stopping can replace a routine comment, and a permission prompt or another session needing you always gets one. A comment stays for 12 seconds, or until what it describes is no longer true, then returns to a greeting. Petting gets an immediate response.
- After 90 seconds without mouse, keyboard, or scroll activity in Tether, Pip takes a nap. Using the app wakes it, and so does a session that needs you. Pip does not nap while a permission prompt is pending.
- Screen readers announce only comments about a session that needs you: a permission prompt, or another session waiting. Other comments, including AI quips, stay visible and silent.
- **Operational nudges** in **Personality & comments** is off by default. When on, Pip comments once when Vault sign-in is within 30 minutes of expiring, a Claude or Codex quota window passes 90%, a daily or weekly usage budget is crossed, or a Tether update is available. Each occurrence is mentioned once per launch, a nudge waits for the current comment to end, and several quota windows over the mark share one comment. Every nudge repeats an indicator the sidebar already shows; Pip is never the only place a warning appears. Nudges are local lines and are never sent to an AI quip backend. With **Quiet** on, Pip changes expression without the comment.
- **Operational nudges** in **Pip options** is off by default. When on, Pip comments once when Vault sign-in is within 30 minutes of expiring, a Claude or Codex quota window passes 90%, a daily or weekly usage budget is crossed, or a Tether update is available. Each occurrence is mentioned once per launch, a nudge waits for the current comment to end, and several quota windows over the mark share one comment. Every nudge repeats an indicator the sidebar already shows; Pip is never the only place a warning appears. Nudges are local lines and are never sent to an AI quip backend. With **Quiet** on, Pip changes expression without the comment.
- Preferences save immediately and persist across launches. Click **Pip** to collapse the panel, or **Hide Pip** to remove it. Reopen it from **View → Pip Sidebar Pet**. Collapsing it, hiding the sidebar, or minimizing the window suspends its timers and cursor tracking; reopening it does not replay missed reactions.

Local reactions use session labels, focus, status metadata, and a text-free typing signal. They make no model or network requests and work with local, SSH, and Coder sessions. How accurately Pip reacts depends on that session's status detection. Pip never parses or alters terminal output.

#### Optional AI quips

- Enable **AI quips through Codex** in **Personality & comments** to get occasional generated comments using your local Codex CLI's ChatGPT sign-in. This uses your subscription allowance. API-key sign-in is not used for Pip. AI comments are off by default.
- Pip selects **GPT-6 Luna**, or **GPT-5.6 Luna** if the current model is absent from the installed CLI's catalog, with the lowest supported reasoning effort and standard speed. It never silently falls back to a larger model. If sign-in, model access, or the connection is unavailable, local quips continue.
- Choose a backend under **AI quips** in **Pip options** to get occasional generated comments: **Codex (ChatGPT sign-in)** uses your local Codex CLI, and **Claude (Claude subscription)** uses your local Claude Code. Either way the quip uses that subscription's allowance; API-key, proxy, and cloud-provider sign-ins are not used for Pip. **Off** keeps local quips only and remembers your last backend. AI quips are off by default. OpenCode is not supported as a quip backend, because `opencode run` gives no error and never exits when a model call fails.
- The backend is always your explicit choice, not the focused session's CLI, because it decides which company receives the request. When you pick one, a status line shows its sign-in and model, or why it cannot be used. **Try a quip** asks for one immediately so you can confirm it works; it skips the two-minute wait but counts toward the hourly limit.
- With Codex, Pip selects **GPT-6 Luna**, or **GPT-5.6 Luna** if the current model is absent from the installed CLI's catalog, with the lowest supported reasoning effort and standard speed. With Claude, Pip uses **Claude Haiku** at low effort and accepts a reply only if it was a single Haiku turn. Neither backend silently falls back to a larger model. If sign-in, model access, or the connection is unavailable, local quips continue.
- Pip can ask for a quip when the focused session starts working, waits for input or a permission, finishes a turn (including a long one), or stops; when another session needs you; when you press **Enter**; and when it gets dizzy. Crashes, helpers joining, and operational nudges keep local lines.
- Requests are limited to one every two minutes and twelve attempts per hour, including failures. Tether enforces both limits outside the panel, and the status line under **Share submitted prompts** shows why a moment got a local line instead. A moment that ends within a fraction of a second, before its request is sent, does not count. Each request is a fresh, temporary conversation. Quiet, collapse, hide, and minimize cancel pending requests; missed events are not replayed.
- While a quip is on its way, the local line stays up rather than expiring under it. A quip that arrives gets its own 12 seconds; if none arrives, the local line keeps the rest of its time. A newer comment, or the end of what the line describes, discards a reply that is still pending.
- By default Pip supplies only the event (for example, an input wait or Enter press) and chosen personality. Session labels, project paths, draft text, and terminal output are excluded from that context. Codex runs the temporary conversation in Tether's neutral app directory rather than your project.
- Separately enable **Share submitted prompts** for specific jokes. Pip reads up to 400 characters of the latest available prompt submitted within the past five minutes from an already-attributed **local Claude or Codex transcript**. Remote sessions and other CLIs use activity only. Common credentials are scrubbed, but arbitrary private text may remain; enabling this sends that excerpt to OpenAI. Pip does not collect draft keystrokes or inspect project files. Tether does not save excerpts or generated comments.
- By default Pip supplies only the event (for example, an input wait or Enter press) and chosen personality. Session labels, project paths, draft text, and terminal output are excluded from that context. Both backends run in Tether's neutral app directory rather than your project. Codex uses a temporary conversation with tools, hooks, apps, plugins, and MCP servers off. Claude runs one prompt with no tools, no MCP servers or skills, and none of your user, project, or local settings, so no hooks run (Tether's included); it saves no session, so nothing is added to your Claude history. Claude Code adds its own environment context, including your account email and that neutral folder.
- Separately enable **Share submitted prompts** for specific jokes. Pip reads up to 400 characters of the latest available prompt submitted within the past five minutes from an already-attributed **local Claude or Codex transcript**. Remote sessions and other CLIs use activity only. Common credentials are scrubbed, but arbitrary private text may remain; enabling this sends that excerpt to the backend's company: OpenAI for Codex, Anthropic for Claude. Choosing another backend turns sharing off, so consent always names the current recipient. Pip does not collect draft keystrokes or inspect project files. Tether does not save excerpts or generated comments. Quips are not counted in Tether's usage totals: Codex quips are temporary conversations and Claude quips save no transcript.

## Terminal

Expand Down
Loading
Loading