diff --git a/README.md b/README.md
index 9ca2d9f..1c40879 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 9c43e56..49cdc35 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 5d6b725..d1b1bfc 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 bfac5d7..dafebae 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 f42f19e..c329057 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 02cd6e7..d0393ab 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"],
diff --git a/plugins/guided-review/README.md b/plugins/guided-review/README.md
index c7e9410..674fc61 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 4b4e3e9..7c1bb22 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 98cbe7f..6ff544a 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 5b99443..943ee73 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 f5b139a..4832ae9 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 b4a7cfe..e1ae851 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),