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 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.
- Web catalog: paseo.cafe
- Registry repository: paseo-cafe/paseo-cafe/tree/main/registry
- Compact index for LLMs:
https://paseo.cafe/llms.txt - Expanded Markdown catalog:
https://paseo.cafe/llms-full.txt - Full JSON catalog:
https://paseo.cafe/api/plugins - OpenAPI document:
https://paseo.cafe/openapi.json - Per-plugin Markdown:
https://paseo.cafe/plugins/<id>.md(e.g.colorful-agent-activity.md) - Per-plugin JSON:
https://paseo.cafe/api/plugin/<id>.json(e.g.colorful-agent-activity.json)
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. |
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. |
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  in assistant markdown, embeds native video player on desktop/web with mobile fallback. |
client/, server/ |
Desktop/web playback only; mobile shows card. |
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. |
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. |
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. |
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). |
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. |
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 customScrollView), 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/acpwithAcpTransformerhooks. - Paseo inline-thinking: Demonstrates custom timeline renderers independent of provider implementations.
- Paseo timeline-items: Canonical
addTimelineTransformerandaddTimelineRenderercontribution patterns.
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.