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
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
7 changes: 6 additions & 1 deletion apps/claude-tty-acp/README.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
1 change: 1 addition & 0 deletions apps/claude-tty-acp/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down
5 changes: 5 additions & 0 deletions plugins/claude-tty/README.md
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
1 change: 1 addition & 0 deletions plugins/claude-tty/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
2 changes: 1 addition & 1 deletion plugins/claude-tty/paseo-plugin.json
Original file line number Diff line number Diff line change
@@ -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"],
Expand Down
2 changes: 1 addition & 1 deletion plugins/guided-review/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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. |
Expand Down
9 changes: 4 additions & 5 deletions plugins/guided-review/client/guide-agent-settings.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -58,11 +58,10 @@ export function GuideAgentSettings({ theme, settings }: { theme: PluginSurfacePr
<Text
style={{ color: theme.colors.foregroundMuted, fontSize: fontSize.sm, lineHeight: leading(fontSize.sm), marginTop: spacing[2] }}
>
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.
</Text>
</SettingsSection>
);
Expand Down
29 changes: 1 addition & 28 deletions plugins/guided-review/server/guide-agent/paseo.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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<string, unknown>[],
waits: [] as Wait[],
responses: [] as { requestId: string; response: PaseoAgentPermissionResponse }[],
Expand Down Expand Up @@ -58,9 +57,6 @@ function stubPaseo() {
async listModes() {
return { modes: state.modes };
},
async listAvailable() {
return { providers: state.available };
},
},
workspaces: {
ref: (workspaceId: string) => ({
Expand Down Expand Up @@ -122,38 +118,15 @@ 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." });

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" }) });
Expand Down
14 changes: 1 addition & 13 deletions plugins/guided-review/server/guide-agent/paseo.ts
Original file line number Diff line number Diff line change
@@ -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";
Expand Down Expand Up @@ -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);
Expand Down Expand Up @@ -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<string> {
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<string> {
const listed = await paseo.providers.listModels(provider, { cwd }).catch((error: unknown) => ({ models: [], error: messageOf(error) }));
const models = (listed.models ?? []).filter((model) => model.isSelectable !== false);
Expand Down
6 changes: 3 additions & 3 deletions plugins/guided-review/server/settings.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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: "",
});
Expand Down
6 changes: 2 additions & 4 deletions plugins/guided-review/shared/settings.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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";

Expand All @@ -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),
Expand Down
Loading