{"id":"activity","repo":"koinzhang/paseo-plugins","url":"https://github.com/koinzhang/paseo-plugins/tree/main/activity","package":"@koinzhang/paseo-plugin-activity","npm":{"package":"@koinzhang/paseo-plugin-activity","version":"0.2.0","integrity":"sha512-UozXsUKZFOAXspvTXtwbKQN2nxlxVKvLGJNM8YPucYhqpetB4b3di9z5DfVsz3BNtb5bvLuJPBkismxarlR42w==","publishedAt":"2026-09-19T11:08:50.168Z","downloadsLast30Days":0},"name":"activity","description":"Local usage analytics for Paseo: tool calls, agents, messages, and model usage.","categories":["monitoring","productivity"],"platforms":[],"caveats":["Requires Paseo 0.8.0 or later"],"images":["https://raw.githubusercontent.com/koinzhang/paseo-plugins/6527b397fada49abbd48395e1d82e812350420d6/activity/images/activity-1.png","https://raw.githubusercontent.com/koinzhang/paseo-plugins/6527b397fada49abbd48395e1d82e812350420d6/activity/images/activity-2.png","https://raw.githubusercontent.com/koinzhang/paseo-plugins/6527b397fada49abbd48395e1d82e812350420d6/activity/images/activity-3.png","https://raw.githubusercontent.com/koinzhang/paseo-plugins/6527b397fada49abbd48395e1d82e812350420d6/activity/images/activity-4.png","https://raw.githubusercontent.com/koinzhang/paseo-plugins/6527b397fada49abbd48395e1d82e812350420d6/activity/images/activity-5.png"],"themes":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":true,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-09-19T11:30:18.400Z","addedAt":"2026-09-19T07:31:15Z","npmSecurity":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-19T11:29:16.128Z","version":"0.2.0","integrity":"sha512-UozXsUKZFOAXspvTXtwbKQN2nxlxVKvLGJNM8YPucYhqpetB4b3di9z5DfVsz3BNtb5bvLuJPBkismxarlR42w=="},"path":"activity","version":"0.2.0","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-19T11:29:16.128Z","commit":"6527b397fada49abbd48395e1d82e812350420d6"},"license":"MIT","paseoVersionRequirement":">=0.8.0","descriptionNodes":[{"type":"text","text":"Local usage analytics for Paseo: tool calls, agents, messages, and model usage."}],"caveatNodes":[[{"type":"text","text":"Requires Paseo 0.8.0 or later"}]],"manifest":{"id":"activity","requirements":{"paseo":">=0.8.0"}},"repoMeta":{"stars":1,"defaultBranch":"main","pushedAt":"2026-09-19T11:17:30Z"},"owner":{"login":"koinzhang","avatarUrl":"https://avatars.githubusercontent.com/u/36128970?v=4"},"installNotesHtml":"<p>Requires Paseo >= 0.8.0.</p>\n<p>From Git (Paseo 0.8 and later):</p>\n<pre><code class=\"language-bash\">paseo plugin add koinzhang/paseo-plugins --path activity\n</code></pre>\n<p>From npm (Paseo 0.9 and later; this is the source paseo.cafe hands to Paseo 0.9+):</p>\n<pre><code class=\"language-bash\">paseo plugin install npm:@koinzhang/paseo-plugin-activity\n</code></pre>\n<p>After source changes, reload and check status:</p>\n<pre><code class=\"language-bash\">paseo plugin reload activity\npaseo plugin logs activity\npaseo plugin ls\n</code></pre>","limitationsNotesHtml":"<ul>\n<li>Analytics and the agent registry are local to each daemon: every machine keeps its own database, and there is no cross-host aggregation.</li>\n<li>Numbers are reconstructed from the Paseo timeline; items that do not report a model or skill cannot be attributed for that dimension.</li>\n<li>Skill classification is heuristic (exact / inferred / low confidence); check the tier before trusting a count.</li>\n<li>Workspace Activity focuses on agent operations for the current workspace; heatmap / provider / model breakdowns stay on the global sidebar.</li>\n</ul>","readmeText":"# Activity\n\nActivity for Paseo: local usage analytics **and** workspace agent management.\n\nIt 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 KPIs and top skills / MCP alongside the list.\n\n| Scope | Role |\n|---|---|\n| **Global** | Cross-workspace habits: heatmap, provider filter, insights, most-used skills / MCP / models |\n| **Workspace** | Per-workspace agent fleet: ranked list + display prefs + archive; shell / file / messages KPIs |\n| **Agent** | Current session: tool KPIs, Skills / MCP detail, SKILL.md reader, composer pill |\n\nArchitecture notes: [docs/architecture.md](./docs/architecture.md).\n\n## What is counted\n\nIngests 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.\n\n| Dimension | What is counted |\n|---|---|\n| Tools | Skill / MCP / shell / file calls; skills classified into exact / inferred / low confidence tiers |\n| Agents | Every created agent (registry with archive metadata) |\n| Messages | User-sent messages |\n| Models | Model at send time (weighted by messages; global view) |\n\n## Where it shows up\n\n- **Sidebar Activity** — global view by provider (heatmap, KPIs, insights, most used)\n- **Explorer → Activity** — workspace agents as a management list (search / sort / group / status / lifecycle / archive) plus workspace KPIs and top skills / MCP\n- **Agent workspace panel** — per-agent tool detail (KPI including messages / Skills / MCP / SKILL.md)\n- **Composer pill** — current agent's skill / MCP summary; hidden when empty\n- **Command Center** — Activity · Workspace Activity · Agent Activity\n\n## Data\n\nEverything lives on the daemon machine in `~/.paseo/plugin-data/activity/` (SQLite `usage.db`). Nothing is sent anywhere.\n\n## Install\n\nRequires Paseo >= 0.8.0.\n\nFrom Git (Paseo 0.8 and later):\n\n```bash\npaseo plugin add koinzhang/paseo-plugins --path activity\n```\n\nFrom npm (Paseo 0.9 and later; this is the source paseo.cafe hands to Paseo 0.9+):\n\n```bash\npaseo plugin install npm:@koinzhang/paseo-plugin-activity\n```\n\nAfter source changes, reload and check status:\n\n```bash\npaseo plugin reload activity\npaseo plugin logs activity\npaseo plugin ls\n```\n\n## Limitations\n\n- Analytics and the agent registry are local to each daemon: every machine keeps its own database, and there is no cross-host aggregation.\n- Numbers are reconstructed from the Paseo timeline; items that do not report a model or skill cannot be attributed for that dimension.\n- Skill classification is heuristic (exact / inferred / low confidence); check the tier before trusting a count.\n- Workspace Activity focuses on agent operations for the current workspace; heatmap / provider / model breakdowns stay on the global sidebar.\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck\nnpm test\n```\n\nThis plugin is spec-driven: read [specs/README.md](./specs/README.md) before coding, then the matching numbered directory.\n\n## Publish\n\nRelease history: [CHANGELOG.md](./CHANGELOG.md). npm releases go through a GitHub Release tag `activity-vX.Y.Z` (not push-to-`main` alone). Steps: [CONTRIBUTING.md § Publishing to npm](../CONTRIBUTING.md#publishing-to-npm).\n\n## License\n\n[MIT](../LICENSE) © koinzhang\n"}