From 4613cf6ca681fe763b65493bd03ce8b5a049bb1f Mon Sep 17 00:00:00 2001 From: Sleeyax Date: Mon, 9 Nov 2026 22:45:59 +0100 Subject: [PATCH 1/2] feat(guided-review): default the guide agent to Paseo's claude provider Paseo 0.14 fixed the usage penalty that made claude-tty the better default, and claude-tty is now deprecated. A host that saved claude-tty in its settings keeps it. Co-Authored-By: Claude Opus 5.5 --- plugins/guided-review/README.md | 2 +- .../client/guide-agent-settings.tsx | 9 +++--- .../server/guide-agent/paseo.test.ts | 29 +------------------ .../guided-review/server/guide-agent/paseo.ts | 14 +-------- plugins/guided-review/server/settings.test.ts | 6 ++-- plugins/guided-review/shared/settings.ts | 6 ++-- 6 files changed, 12 insertions(+), 54 deletions(-) diff --git a/plugins/guided-review/README.md b/plugins/guided-review/README.md index c7e9410b..674fc616 100644 --- a/plugins/guided-review/README.md +++ b/plugins/guided-review/README.md @@ -119,7 +119,7 @@ On GitHub your review stays on the commit the guide explained, so a repository t | --- | --- | --- | | gh path | `gh` | The `gh` the daemon runs: a command on its `PATH` or an absolute path. | | glab path | `glab` | The `glab` the daemon runs, the same way. | -| Provider and model | `claude-tty` | The agent that writes guides: a provider, or `provider/model` like `codex/gpt-5.5`. Falls back to `claude` when the [claude-tty](../claude-tty) provider is not available. | +| Provider and model | `claude` | The agent that writes guides: a provider, or `provider/model` like `codex/gpt-5.5`. | | Effort | _blank_ | The model's effort level, like `high`. Blank uses the model's default. | | Mode | _blank_ | The guide agent's mode. Blank uses the provider's plan or read-only mode. Only modes that ask before running a tool are accepted. | | Syntax theme | GitHub | The theme diffs are highlighted with. Pick the same one as under Appearance in Paseo's settings, which plugins cannot read. | diff --git a/plugins/guided-review/client/guide-agent-settings.tsx b/plugins/guided-review/client/guide-agent-settings.tsx index 4b4e3e9c..7c1bb22c 100644 --- a/plugins/guided-review/client/guide-agent-settings.tsx +++ b/plugins/guided-review/client/guide-agent-settings.tsx @@ -58,11 +58,10 @@ export function GuideAgentSettings({ theme, settings }: { theme: PluginSurfacePr - The agent that writes each guide and answers questions about it, such as claude-tty, claude/claude-opus-5-5 or - codex/gpt-5.5. The default, claude-tty, becomes claude where the claude-tty plugin is not available. It runs - read-only: in plan or read-only mode unless you pick another mode that asks first, and with every request to - edit, write or run a command denied. A mode that runs tools without asking, like acceptEdits or auto, is - refused. + The agent that writes each guide and answers questions about it, such as claude, claude/claude-opus-5-5 or + codex/gpt-5.5. It runs read-only: in plan or read-only mode unless you pick another mode that asks first, and + with every request to edit, write or run a command denied. A mode that runs tools without asking, like + acceptEdits or auto, is refused. ); diff --git a/plugins/guided-review/server/guide-agent/paseo.test.ts b/plugins/guided-review/server/guide-agent/paseo.test.ts index 98cbe7f6..6ff544a4 100644 --- a/plugins/guided-review/server/guide-agent/paseo.test.ts +++ b/plugins/guided-review/server/guide-agent/paseo.test.ts @@ -17,7 +17,6 @@ function stubPaseo() { { provider: "claude", id: "claude-opus-5-5", label: "Opus 5.5", isDefault: true }, ] as { provider: string; id: string; label: string; isDefault?: boolean }[], modes: [{ id: "default", label: "Default" }, { id: "plan", label: "Plan" }] as { id: string; label: string; colorTier?: string }[], - available: [{ provider: "claude", available: true }] as { provider: string; available: boolean }[], created: [] as Record[], waits: [] as Wait[], responses: [] as { requestId: string; response: PaseoAgentPermissionResponse }[], @@ -58,9 +57,6 @@ function stubPaseo() { async listModes() { return { modes: state.modes }; }, - async listAvailable() { - return { providers: state.available }; - }, }, workspaces: { ref: (workspaceId: string) => ({ @@ -122,9 +118,8 @@ test("a configured model is used as it is, and a provider that offers no read-on assert.deepEqual(state.created[0]!.config, { provider: "opencode/big-model" }); }); -test("the default claude-tty is used where its plugin's provider is available", async () => { +test("a host that names claude-tty keeps getting it", async () => { const { paseo, state } = stubPaseo(); - state.available = [{ provider: "claude-tty", available: true }]; const agents = createPaseoGuideAgents({ paseo: () => paseo, agent: async () => ({ agent: "claude-tty", effort: "", mode: "" }) }); await agents.create({ workspace: WORKSPACE, title: "Guide", labels: {}, prompt: "Explain." }); @@ -132,28 +127,6 @@ test("the default claude-tty is used where its plugin's provider is available", assert.deepEqual(state.created[0]!.config, { provider: "claude-tty/claude-opus-5-5", modeId: "plan" }); }); -test("the default claude-tty gives way to claude where its plugin's provider is missing or unavailable", async () => { - for (const available of [[], [{ provider: "claude-tty", available: false }]]) { - const { paseo, state } = stubPaseo(); - state.available = available; - const agents = createPaseoGuideAgents({ paseo: () => paseo, agent: async () => ({ agent: "claude-tty", effort: "", mode: "" }) }); - - await agents.create({ workspace: WORKSPACE, title: "Guide", labels: {}, prompt: "Explain." }); - - assert.deepEqual(state.created[0]!.config, { provider: "claude/claude-opus-5-5", modeId: "plan" }); - } -}); - -test("claude-tty with a model is taken as asked for, available or not", async () => { - const { paseo, state } = stubPaseo(); - state.available = []; - const agents = createPaseoGuideAgents({ paseo: () => paseo, agent: async () => ({ agent: "claude-tty/opus", effort: "", mode: "" }) }); - - await agents.create({ workspace: WORKSPACE, title: "Guide", labels: {}, prompt: "Explain." }); - - assert.deepEqual(state.created[0]!.config, { provider: "claude-tty/opus", modeId: "plan" }); -}); - test("a configured effort and asking mode are passed on as they are", async () => { const { paseo, state } = stubPaseo(); const agents = createPaseoGuideAgents({ paseo: () => paseo, agent: async () => ({ agent: "claude", effort: "high", mode: "default" }) }); diff --git a/plugins/guided-review/server/guide-agent/paseo.ts b/plugins/guided-review/server/guide-agent/paseo.ts index 5b994433..943ee736 100644 --- a/plugins/guided-review/server/guide-agent/paseo.ts +++ b/plugins/guided-review/server/guide-agent/paseo.ts @@ -1,5 +1,4 @@ import type { PaseoAgent, PaseoAgentHandle, PaseoAgentPermissionResponse, PaseoApi } from "@getpaseo/client"; -import { DEFAULT_GUIDE_AGENT, FALLBACK_GUIDE_AGENT } from "../../shared/settings.ts"; import type { GuideAgentSettings } from "../settings.ts"; import { GUIDE_AGENT_LABEL, GuideAgentError, type GuideAgentPort } from "./port.ts"; import { readOnlyCommand } from "./read-only-command.ts"; @@ -198,7 +197,7 @@ export function createPaseoGuideAgents(options: PaseoGuideAgentsOptions): PaseoG async create({ workspace, title, labels, prompt, outputSchema }) { const paseo = options.paseo(); const configured = await options.agent(); - const { provider, model } = parseAgentSetting(await availableAgent(paseo, configured.agent)); + const { provider, model } = parseAgentSetting(configured.agent); if (provider === "") throw new GuideAgentError("No guide agent provider is configured."); const resolvedModel = model ?? (await defaultModel(paseo, provider, workspace.directory)); const modes = await paseo.providers.listModes(provider, { cwd: workspace.directory }).catch(() => null); @@ -257,17 +256,6 @@ export function createPaseoGuideAgents(options: PaseoGuideAgentsOptions): PaseoG }; } -/** - * The setting, unless it is the default and the claude-tty plugin that provides it is not available here. - * A listing that fails leaves the setting as it is, so the creation says what went wrong with it. - */ -async function availableAgent(paseo: PaseoApi, setting: string): Promise { - if (setting.trim() !== DEFAULT_GUIDE_AGENT) return setting; - const listed = await paseo.providers.listAvailable().catch(() => null); - if (listed === null) return setting; - return listed.providers.some((entry) => entry.provider === DEFAULT_GUIDE_AGENT && entry.available) ? setting : FALLBACK_GUIDE_AGENT; -} - async function defaultModel(paseo: PaseoApi, provider: string, cwd: string): Promise { const listed = await paseo.providers.listModels(provider, { cwd }).catch((error: unknown) => ({ models: [], error: messageOf(error) })); const models = (listed.models ?? []).filter((model) => model.isSelectable !== false); diff --git a/plugins/guided-review/server/settings.test.ts b/plugins/guided-review/server/settings.test.ts index f5b139a3..4832ae9b 100644 --- a/plugins/guided-review/server/settings.test.ts +++ b/plugins/guided-review/server/settings.test.ts @@ -21,13 +21,13 @@ test("runs the glab the settings name, and glab on the PATH when they name none" assert.equal(await readGlabPath(settingsReading({ status: "invalid", revision: "1", error: "Invalid settings" })), "glab"); }); -test("the guide agent is the one the settings name, and Claude TTY's default model when they name none", async () => { +test("the guide agent is the one the settings name, and Claude's default model when they name none", async () => { const ready = (guideAgent: string, guideAgentEffort = "", guideAgentMode = "") => settingsReading({ status: "ready", revision: "1", values: { ghPath: "gh", glabPath: "glab", guideAgent, guideAgentEffort, guideAgentMode, syntaxTheme: "github" } }); assert.deepEqual(await readGuideAgent(ready("codex/gpt-5.5")), { agent: "codex/gpt-5.5", effort: "", mode: "" }); - assert.deepEqual(await readGuideAgent(ready(" ", " high ", " default ")), { agent: "claude-tty", effort: "high", mode: "default" }); + assert.deepEqual(await readGuideAgent(ready(" ", " high ", " default ")), { agent: "claude", effort: "high", mode: "default" }); assert.deepEqual(await readGuideAgent(settingsReading({ status: "invalid", revision: "1", error: "Invalid settings" })), { - agent: "claude-tty", + agent: "claude", effort: "", mode: "", }); diff --git a/plugins/guided-review/shared/settings.ts b/plugins/guided-review/shared/settings.ts index b4a7cfe3..e1ae851e 100644 --- a/plugins/guided-review/shared/settings.ts +++ b/plugins/guided-review/shared/settings.ts @@ -5,9 +5,7 @@ export const SETTINGS_ID = "settings"; export const DEFAULT_GH_PATH = "gh"; /** Claude with whichever model its provider calls the default, so a new model needs no settings change. */ -export const DEFAULT_GUIDE_AGENT = "claude-tty"; -/** What the default gives way to on a host where the claude-tty plugin's provider is not available. */ -export const FALLBACK_GUIDE_AGENT = "claude"; +export const DEFAULT_GUIDE_AGENT = "claude"; export const DEFAULT_GLAB_PATH = "glab"; @@ -32,7 +30,7 @@ export const settingsDocument = defineSettings({ /** The `glab` executable, read the same way as `ghPath`. */ glabPath: z.string().default(DEFAULT_GLAB_PATH), /** - * The guide agent's provider, alone for its default model (`claude-tty`) or with a model + * The guide agent's provider, alone for its default model (`claude`) or with a model * (`codex/gpt-5.5`), as Paseo names them. Checked only when a guide agent is created. */ guideAgent: z.string().default(DEFAULT_GUIDE_AGENT), From fe949a3a417d79865d24868e3ca899d79dd4b1a6 Mon Sep 17 00:00:00 2001 From: Sleeyax Date: Mon, 9 Nov 2026 22:45:59 +0100 Subject: [PATCH 2/2] feat(claude-tty): deprecate the plugin and its adapter Paseo 0.14's built-in claude provider no longer has the usage penalty they were built to avoid. Both stay installable because the penalty may come back and existing threads still use the provider. Co-Authored-By: Claude Opus 5.5 --- README.md | 8 ++++---- apps/claude-tty-acp/README.md | 7 ++++++- apps/claude-tty-acp/package.json | 1 + plugins/claude-tty/README.md | 5 +++++ plugins/claude-tty/package.json | 1 + plugins/claude-tty/paseo-plugin.json | 2 +- 6 files changed, 18 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 9ca2d9fe..1c408799 100644 --- a/README.md +++ b/README.md @@ -8,12 +8,12 @@ My plugins for [Paseo](https://github.com/getpaseo/paseo). | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | | [Discord Rich Presence](plugins/discord-rich-presence) | Show your current Paseo activity on Discord. | | [Catppuccin theme](plugins/catppuccin-theme) | Add all four Catppuccin flavours as app themes. | -| [Claude TTY](plugins/claude-tty) | Offer the Claude TTY ACP adapter as a Paseo provider, and manage it on the daemon host. | +| [Claude TTY](plugins/claude-tty) | Deprecated: offer the Claude TTY ACP adapter as a Paseo provider, and manage it on the daemon host. | | [Guided Review](plugins/guided-review) | Show a trunk-first guide to a pull request or merge request, and build your draft review alongside it. | -| ACP | Description | -| ------------------------------------- | -------------------------------------------------------------------------- | -| [Claude TTY ACP](apps/claude-tty-acp) | Run genuine interactive Claude Code sessions in Paseo's native agent view. | +| ACP | Description | +| ------------------------------------- | -------------------------------------------------------------------------------------- | +| [Claude TTY ACP](apps/claude-tty-acp) | Deprecated: run genuine interactive Claude Code sessions in Paseo's native agent view. | ## Installation diff --git a/apps/claude-tty-acp/README.md b/apps/claude-tty-acp/README.md index 9c43e566..49cdc35f 100644 --- a/apps/claude-tty-acp/README.md +++ b/apps/claude-tty-acp/README.md @@ -1,12 +1,17 @@ # Claude TTY ACP +> [!WARNING] +> **Deprecated**, along with the [Claude TTY plugin](../../plugins/claude-tty/README.md) that installs it. +> Use Paseo's built-in `claude` provider for new agents. +> This adapter stays available, so threads that already use it keep working. + An [ACP](https://agentclientprotocol.com) adapter that runs the real interactive Claude Code CLI as a Paseo agent. Each session is one `claude` process in a terminal, and you get Paseo's native timeline, tool calls, plans, permission cards and pickers on top of it. ## Why? Paseo's built-in Claude agent runs on the Claude Agent SDK. -Agent SDK integrations appear to consume usage limits faster than the Claude Code CLI does, [as reported for t3code and similar tools](https://github.com/pingdotgg/t3code/issues/7338#issuecomment-5426425282). +Before Paseo 0.14, its sessions appeared to consume usage limits faster than the Claude Code CLI does, [as reported for t3code and similar tools](https://github.com/pingdotgg/t3code/issues/7338#issuecomment-5426425282). This adapter avoids the SDK by driving the same CLI you would run in a terminal. You keep its binary, login, billing, sessions, `CLAUDE.md` files, MCP servers, plugins, skills and permission rules. The cost is that Paseo's features are rebuilt from Claude's transcripts, hooks and screen, which is where the [limitations](#limitations) come from. diff --git a/apps/claude-tty-acp/package.json b/apps/claude-tty-acp/package.json index 5d6b7259..d1b1bfc2 100644 --- a/apps/claude-tty-acp/package.json +++ b/apps/claude-tty-acp/package.json @@ -2,6 +2,7 @@ "name": "@paseo-plugins/claude-tty-acp", "private": true, "version": "0.5.0", + "deprecated": "Use Paseo's built-in claude provider (Paseo 0.14 or newer). Kept so existing threads keep working.", "description": "ACP adapter for interactive Claude Code sessions", "type": "module", "bin": { diff --git a/plugins/claude-tty/README.md b/plugins/claude-tty/README.md index bfac5d7b..dafebae8 100644 --- a/plugins/claude-tty/README.md +++ b/plugins/claude-tty/README.md @@ -1,5 +1,10 @@ # Claude TTY +> [!WARNING] +> **Deprecated.** Since Paseo 0.14, the built-in `claude` provider no longer has the usage penalty this plugin was built to avoid. +> Use `claude` for new agents. +> This plugin stays available, so threads that already use it keep working. + Adds **Claude TTY** to Paseo's providers: the real interactive Claude Code CLI, run in a terminal by the [Claude TTY ACP adapter](../../apps/claude-tty-acp). A sidebar panel diagnoses the adapter and manages its saved sessions on the selected host. diff --git a/plugins/claude-tty/package.json b/plugins/claude-tty/package.json index f42f19ec..c3290575 100644 --- a/plugins/claude-tty/package.json +++ b/plugins/claude-tty/package.json @@ -2,6 +2,7 @@ "name": "@paseo-plugins/claude-tty", "private": true, "version": "0.5.0", + "deprecated": "Use Paseo's built-in claude provider (Paseo 0.14 or newer). Kept so existing threads keep working.", "scripts": { "identity": "node scripts/set-identity.mjs", "typecheck": "tsc --noEmit", diff --git a/plugins/claude-tty/paseo-plugin.json b/plugins/claude-tty/paseo-plugin.json index 02cd6e70..d0393abb 100644 --- a/plugins/claude-tty/paseo-plugin.json +++ b/plugins/claude-tty/paseo-plugin.json @@ -1,6 +1,6 @@ { "id": "claude-tty", - "description": "Run Claude Code in its real terminal UI as a Paseo agent, with suspend/resume and card-based permission prompts.", + "description": "Deprecated: use Paseo's built-in claude provider for new agents. Run Claude Code in its real terminal UI as a Paseo agent, with suspend/resume and card-based permission prompts.", "requirements": { "paseo": ">=0.13.0" }, "build": [ ["pnpm", "install", "--frozen-lockfile"],