paseo.cafe is deprecated. Browse plugins at paseo.sh/plugins and submit new ones there. This catalog and its API stop on 2026-12-01. The Paseo Cafe companion plugin already uses the official registry and is unaffected.
paseo.cafe
All plugins

activity

by koinzhang

Local usage analytics and workspace agent ops for Paseo: tools, agents, messages, models, Explorer fleet list, and terminals.

v0.7.0 Requires Paseo >=0.9.0

Gallery

Install

npmjs · Paseo 0.9+

paseo plugin add npm:@koinzhang/paseo-plugin-activity@0.7.0

GitHub · Paseo 0.8 fallback

paseo plugin add koinzhang/paseo-plugins --ref 7c2d3ce8a7435f45cd17ef0b2cb2deda5e5c993a --path activity

Git security status and fallback installation are pinned to commit 7c2d3ce8a743.

From the plugin's README

Requires Paseo >= 0.9.0. 0.4.0 is the last release that supports Paseo 0.8.0.

From Git (Paseo 0.9 and later):

paseo plugin add koinzhang/paseo-plugins --path activity

From npm (Paseo 0.9 and later; this is the source paseo.cafe hands to Paseo 0.9+). Pin 0.4.0 on Paseo 0.8:

paseo plugin install npm:@koinzhang/paseo-plugin-activity

README

Activity

Activity for Paseo: local usage analytics and workspace agent management.

It still answers “how am I using Paseo” (tools, messages, models, habits). With the Explorer Workspace Activity panel it also becomes a vertical ops surface for the agents in the current workspace — sort, filter, search, open, archive — with live attention cues, open terminals, KPIs, and top skills / MCP.

Scope Role
Global Cross-workspace habits: KPI vs the previous 7 days, daily heatmap, rolling 168-hour activity timeline, Provider: All ▾ filter, per-chart Sessions / Prompts / Skill calls / MCP calls switches, collapsible Providers / Projects rankings, insights, most-used skills / MCP / models
Workspace Per-workspace agent fleet: ranked list + display prefs + archive; live status (permission / finished / error / running); open Terminals; shell / file / prompt KPIs; times via shared FormattedTime
Agent Current session: dense tool KPIs, Skills / MCP header toggle, SKILL.md reader, composer Activity pill; Needs attention pill jumps to other same-workspace finished/permission/error sessions

Architecture notes: docs/architecture.md.

What is counted

Ingests every agent's Paseo timeline into a local SQLite database. Queries read that database; the timeline and agents.list are ingestion / backfill / live-status sources only.

Dimension What is counted
Tools Skill / MCP / shell / file calls; skills classified into exact / inferred / low confidence tiers
Agents Every created agent (registry with archive metadata)
Prompts User-sent messages (called Prompts in every Activity view)
Models Model at send time (weighted by messages; global view)

Where it shows up

  • Sidebar Activity — all-time global view by provider (KPI with prev-7d comparison, Activity Calendar heatmap, Daily Activity 30-day histogram, Hourly Activity 168-hour timeline, Providers / Projects rankings, insights, most used)
  • Explorer → Activity (or the Activity button in a workspace header; hidden while the panel is open) — workspace agents as a management list (search / sort / group / status / lifecycle / archive), live attention (permission badge, status colors, running spinner; API-owned directory observation + explicit lifecycle/archive fields + 15s reconciliation), open Terminals (list / preview / close), plus workspace KPIs and Skills / MCP ranked or newest-call timeline views (with agent titles and one shared persisted view choice); usage queries get a best-effort refresh hint when agents leave running
  • Agent workspace panel — per-agent tool detail (dense KPI including prompts / Skills / MCP toggle / SKILL.md); refreshes on timeline turn terminal events
  • Composer pills — Activity: current agent's skill / MCP summary (hidden when empty); Needs attention: other same-workspace agents with finished / permission / error (hidden when none; click opens shared list)
  • Command Center — Activity · Workspace Activity · Agent Activity

Data

Everything lives on the daemon machine in ~/.paseo/plugin-data/activity/ (SQLite usage.db). Nothing is sent anywhere.

Install

Requires Paseo >= 0.9.0. 0.4.0 is the last release that supports Paseo 0.8.0.

From Git (Paseo 0.9 and later):

paseo plugin add koinzhang/paseo-plugins --path activity

From npm (Paseo 0.9 and later; this is the source paseo.cafe hands to Paseo 0.9+). Pin 0.4.0 on Paseo 0.8:

paseo plugin install npm:@koinzhang/paseo-plugin-activity
# Paseo 0.8: npm:@koinzhang/paseo-plugin-activity@0.4.0

From a local checkout (development), run this inside activity/. It uses the same plugin ID activity, so don't pass --id, and it shares the same data directory:

paseo plugin install "$PWD"   # absolute path; `paseo plugin remove activity` first if npm is installed

After source changes, reload and check status:

paseo plugin reload activity
paseo plugin logs activity
paseo plugin ls

Limitations

  • Analytics and the agent registry are local to each daemon: every machine keeps its own database, and there is no cross-host aggregation.
  • Numbers are reconstructed from the Paseo timeline; items that do not report a model or skill cannot be attributed for that dimension.
  • Skill classification is heuristic (exact / inferred / low confidence); check the tier before trusting a count.
  • Project attribution for the Projects ranking comes from the workspace root recorded while it was listed, or the agent cwd; sessions with neither group under Other.
  • Workspace Activity focuses on agent operations for the current workspace; heatmap / provider / model breakdowns stay on the global sidebar.

Development

npm install
npm run typecheck
npm test

This plugin is spec-driven: read specs/README.md before coding, then the matching numbered directory.

Publish

Release history: CHANGELOG.md (current 0.7.0). npm releases go through a GitHub Release tag activity-vX.Y.Z (not push-to-main alone). Steps: CONTRIBUTING.md § Publishing to npm.

License

MIT © koinzhang

Scanned 15 Oct 2026, 12:28 UTC from koinzhang/paseo-plugins/activity.