Skip to content

Latest commit

 

History

History
179 lines (133 loc) · 23.1 KB

README.md

File metadata and controls

179 lines (133 loc) · 23.1 KB

Paseo plugin reference index

Reviewed community and official plugins to consult alongside the Paseo v0.8 documentation. The community registry at paseo.cafe indexes community-built plugins straight from their GitHub repositories and provides machine-readable feeds for agents and tooling.

When developing plugins, treat third-party projects' legacy single-entry structures (index.ts) and private host integrations as implementation details; prefer documented Paseo v0.8 APIs and the guidance in ../AGENTS.md.

The paseo.cafe registry ecosystem

The paseo.cafe registry indexes public Paseo plugins. Each listing is driven by a single JSON entry (registry/<plugin-id>.json) pointing to a GitHub repository, with metadata, categories, platforms, and caveats verified by CI.

Discovery and machine-readable interfaces


1. Surfaces, dashboards, and navigation

Plugins contributing host-wide screens (client.addSurface), sidebar items (client.addSidebarItem), and cross-workspace management tools.

Plugin & links Study for Useful locations / implementation Caveats & platforms
github-board • cafe 4-column GitHub work surface (addSurface), RPC queries to daemon-side gh CLI, optimistic status changes. github-board/board.client.tsx, github-board/board.server.ts Requires gh authenticated on daemon host.
agent-monitor • cafe Host-wide triage roster across all workspaces, theme-derived FlatList, debounced subscription refetches. src/components/agent-monitor.client.tsx, src/lib/monitor.shared.ts Requires Paseo 0.8.x.
agents-dash-list • cafe Sidebar dashboard of workspaces grouped by status (waiting, unread, in progress, idle, closed), unread tracking. agents-dash-list/client/, agents-dash-list/server/ Unread marks stay on the daemon that stored them.
agents-history • cafe Global search over all workspaces and archived agents, on-disk transcript parsing, local SQLite/JSON search index. agents-history/client/, agents-history/server/ Reads local transcripts on disk.
paseo-cafe • cafe Native in-app plugin catalog browser and installer (client.addSurface), calls daemon paseo CLI to install. plugin/client/, plugin/server/ Runs paseo CLI on daemon host; requires network.
k8s • cafe Kubernetes workloads, streaming pod logs, GitOps integration, and interactive kubectl command bar. client/, server/ Requires reachable cluster credentials on daemon.
launchd-jobs • cafe macOS LaunchAgent scheduler and monitor surface, cron expression and interval parsing, launchd IPC. launchd-jobs/jobs.client.tsx, launchd-jobs/jobs.server.ts macOS only; requires active GUI login session.
schedule-runs • cafe Sidebar feed of scheduled agent runs with status, archived states, and final responses. schedule-runs/client/, schedule-runs/server/ Read-only feed of existing schedule runs.
paseo-mcp • cafe Surface for managing host and workspace MCP servers, project credentials, and OAuth handshakes. client/, server/ Manages daemon config and credentials.
paseo-prompt-manager • cafe Prompt library surface with version history, file imports, and optional Git sync. client/, server/ Local filesystem persistence.
shared-browser • cafe One shared Chromium session per workspace, remote frame streaming via WebSockets to React Native canvas. client/, server/ Installs ~180MB Chromium download on daemon host.
daemon-link • cafe Multi-daemon management, localhost tunnel discovery, Git project transfers, and host telemetry. client/, server/ Multi-host network setup.

2. Workspace and agent panels

Plugins contributing inspector and contextual tool panels (client.addWorkspacePanel) in the workspace, explorer, or agent locations.

Plugin & links Study for Useful locations / implementation Caveats & platforms
skills • cafe Lists available agent skills, parses and renders SKILL.md documents, invokes skills into conversation. skills/panel.client.tsx, skills/skills.server.ts Reads skill locations on daemon host.
agent-crew • cafe Explorer panel for visualizing and orchestrating multi-agent crews within a workspace. client/, server/ Requires Paseo 0.8.x.
setup-monitor • cafe Live view of worktree.setup execution subscribing to workspace_setup_status stream during setup. client/, server/ Tracks setup commands declared in paseo.json.
review-deck • cafe Human-in-the-loop code review panel, file diff inspection, inline comments, agent task generation. client/, server/ Requires Paseo 0.8.x.
branch-garden • cafe Git branch management, worktree visualizer, status indicators inside workspace panel. plugins/branch-garden/client/ Paseo 0.8.0 Windows/macOS/Linux.
command-deck • cafe Interactive command launcher and output viewer in workspace panel. plugins/command-deck/client/ Paseo 0.8.0.
prompt-palette • cafe Contextual prompt template library and quick-insertion panel. plugins/prompt-palette/client/ Paseo 0.8.0.
workspace-activity • cafe Workspace task list and agent status panel. client/, server/ Workspace-level aggregation.
workspace-links • cafe Setup and management panel for URLs declared in .paseo/workspace-links.json. client/, server/ Opens links in daemon host browser.

3. Timeline transformers and custom renderers

Plugins modifying or replacing transcript rows (client.addTimelineTransformer, client.addTimelineRenderer). Paseo v0.8 supports live streaming transformation without remounting using { item, phase }.

Plugin & links Study for Useful locations / implementation Caveats & platforms
colorful-agent-activity • cafe Dense IDE-style tool & reasoning cards, streaming expansion, Prism syntax highlighting, automated Hermes mobile bundle test. client/activity.tsx, client/highlight.ts, client/bundle.test.ts Detailed tool mode; mobile-safe (Hermes verified).
readable-agent-activity • cafe Clean tool call and reasoning presentation, JSON syntax formatting, bounded payload folding. plugins/agent-activity/client/ Full detail only; do not stack with other transformers.
math-renderer • cafe Renders block LaTeX in assistant messages using local MathJax and embedded resvg WASM. plugins/math-renderer/client/ Block math only; fallback on unsupported macros.
video-embeds • cafe Parses ![clip](/path.mp4) in assistant markdown, embeds native video player on desktop/web with mobile fallback. client/, server/ Desktop/web playback only; mobile shows card.

4. Composer pills, modals, and contextual actions

Plugins adding interactive pills (client.addComposerPill), modal dialogs, and slash commands to the message composer.

Plugin & links Study for Useful locations / implementation Caveats & platforms
time-since • cafe Live ticking elapsed timer pill showing duration since last user or assistant message in thread. client/time-since.tsx Pure client-side timeline observation.
chat-resume • cafe Contextual pills appearing only on quota/limit errors to resume, wait for allowance, or prepare handover. chat-resume/client/ Conditional pill visibility based on last agent error.
agent-heartbeats • cafe Composer pill showing heartbeat count with modal dialog to create, edit, and cancel recurring prompts. agent-heartbeats/client/, agent-heartbeats/server/ Modifying heartbeat resets run history.
remote-editor • cafe Composer pill opening the workspace in VS Code or Zed over SSH on desktop. client/, server/ Desktop only; requires SSH remote extension.
vscode-open-remote • cafe Composer pill opening workspace directory in VS Code, Cursor, or vscode.dev tunnel. client/, server/ Desktop & tablet only; requires matching tunnel.
workspace-links • cafe Composer pill and header button showing quick-open menu of URLs defined in workspace config. client/, server/ Opens URL in daemon host default browser.
paseo-plain • cafe Composer trigger to rewrite assistant response in plain English without modifying canonical conversation. client/, server/ Preserves original transcript.
paseo-prometheus-status • cafe Dynamic warning pill appearing only when GPU temperature, VRAM, or power cross configured thresholds. client/, server/ Requires reachable Prometheus endpoint.

5. Agent providers and ACP adapters

Plugins registering coding agents via server.registerProvider() implementing ProviderRegistration, or adapting external agents via runAcpProvider().

Plugin & links Study for Useful locations / implementation Caveats & platforms
commandcode-provider • cafe Stdio CLI wrapper provider for Command Code, streaming output mapping, effort level negotiation. server/provider.ts, server/session.ts Requires commandcode CLI on daemon PATH.
agy-provider • cafe Provider adapter for Google Antigravity ACP server, Command Center login flow, capability negotiation. server/ macOS ARM64 verified; Node 22.18+ on daemon.
deepseek-harness • cafe ACP profile adapter for DeepSeek Harness, native context resumption without transcript replay. plugins/deepseek-harness/server/ Requires DSH 0.1.5-rc.1/2 and credentials.
zcode-provider • cafe Headless integration with ZCode desktop app, custom tool dispatch, model discovery. server/ Unofficial headless connection; macOS/Linux/Windows.
acp-manager • cafe Sidebar management UI for ACP providers, testing initialize handshake, quick-add from ACP registry. client/, server/ Direct $PASEO_HOME/config.json edits; runs paseo reload.
obol • cafe Multi-subscription proxy behind provider, live credential switching without restarting daemon. server/ Provider routing proxy.
agent-link-9router • cafe Provider routing bridge connecting external multi-model router into Paseo. apps/paseo/ External routing service.

6. Usage, quotas, and telemetry

Plugins tracking token usage, plan allowances, API costs, and system resources.

Plugin & links Study for Useful locations / implementation Caveats & platforms
usage-sidebar • cafe Always-visible sidebar quota meter + full breakdown panel, reads Paseo's native usage state. client/, server/ Requires Paseo 0.8.0+; meter desktop/web only.
provider-usage • cafe Sidebar surface tracking Claude, Codex, and Antigravity plan usage with stale-while-revalidate caching. usage.shared.ts, usage.server.ts, main.client.tsx Stale-while-revalidate; per-provider error isolation.
usage-monitor • cafe Model token usage limits, balance tracking, and reading local CLI credential files. client/, server/ Reads local provider configuration files.
session-usage • cafe Transcript parser for Claude/Codex costs, sortable statistics, visual charts, and CSV data export. session-usage/client/, session-usage/server/ Reads local disk transcripts; no billing API needed.
smart-session • cafe Historical plan-usage tracking, automatic context pruning for long-running sessions. client/, server/ Claude plan-focused.
paseo-prometheus-status • cafe Prometheus metrics subscriber polling GPU VRAM, utilization, power, and temperatures. client/, server/ Requires reachable Prometheus instance.

7. Git, worktrees, lifecycle, and automation

Plugins intercepting daemon lifecycle events (onAgentCreate, onAgentArchive), automating Git, or connecting external triggers.

Plugin & links Study for Useful locations / implementation Caveats & platforms
archive-branch-cleanup • cafe Server daemon lifecycle hook (onAgentArchive) automatically deleting the local Git branch on archive. index.server.ts Operates on Paseo-created worktree branches.
fresh-worktrees • cafe Intercepts branch-off worktree creation to fast-forward local base branches, preventing stale branches. server/ Requires Paseo 0.8.0-beta.1+; aborts if fetch fails.
paseo-defer • cafe Queue messages to coding agents until a future timestamp or plan reset window, timer cleanup, daemon client. defer.shared.ts, store.server.ts, engine.server.ts Durable persisted queue; bundle-boundary checks.
tell-agent • cafe Inter-agent messaging and orchestration across different workspaces. client/, server/ Requires Paseo 0.8.x.
send-to-paseo • cafe Local daemon HTTP bridge listening for browser extension clicks to create PR worktrees automatically. plugin/server/, plugin/client/ Companion Chrome extension; requires git on daemon.
discord-rich-presence • cafe Daemon-side local IPC socket connection to Discord desktop client for live rich activity presence. plugins/discord-rich-presence/ Linux and macOS; Discord must run on same machine.
paseo-display-switcher • cafe Keyboard shortcuts (⌘K) and Command Center triggers to switch sidebar view modes. client/ Private host state workarounds (reference only).

8. Themes and appearance

Plugins contributing custom semantic palettes (client.addTheme).

Plugin & links Study for Useful locations / implementation Caveats & platforms
catppuccin-theme • cafe Adds 4 theme variations (Latte, Frappé, Macchiato, Mocha) via static addTheme registrations. plugins/catppuccin-theme/index.client.tsx Pure client theme registration.
paseo-dracula • cafe Dracula Classic and Alucard Classic theme palettes for Paseo. index.client.tsx Pure client theme registration.

9. Official Paseo v0.8 plugin examples

Official example plugins from the getpaseo/paseo v0.8.0 repository:

  • Paseo settings example: Contributes dedicated settings screens via client.addSettingsScreen({ id, title, icon, Component }).
  • Paseo modal-ui example: Demonstrates modal layouts, scrolling (scrollable={false} with custom ScrollView), and clipboard actions (client.clipboard.copyText).
  • Paseo lifecycle-actions and lifecycle-logger: Demonstrates observing and customizing agent and workspace lifecycle events (server.agents.onAgentCreate, archiving hooks).
  • Paseo agent-configuration: Shows customizing agent parameters and config on the server.
  • Paseo provider-direct: Complete coding agent provider implementation via server.registerProvider(createProvider()), models/modes catalog, session lifecycle, composer toggle/select settings, turns, steering, and history replay.
  • Paseo provider-acp-transformer: Adapting a command-backed ACP agent using runAcpProvider() from @getpaseo/plugin/server/acp with AcpTransformer hooks.
  • Paseo inline-thinking: Demonstrates custom timeline renderers independent of provider implementations.
  • Paseo timeline-items: Canonical addTimelineTransformer and addTimelineRenderer contribution patterns.

10. Local plugins in this repository

Reference implementations maintained within this repository:

  • colorful-agent-activity: Timeline transformer replacing reasoning and tool-call rows with dense IDE cards, Prism syntax highlighting, and automated Hermes mobile bundle tests.