agentop 0.1.0 → 0.1.2

package/README.md

@@ -12,7 +12,7 @@ which projects have agents working, what model they're on, which git branch
 they're on, and what each one is doing *right now* (running a tool, thinking,
 or waiting for you).
 
-![agentop in action](docs/screenshot.png)
+![agentop in action](https://raw.githubusercontent.com/ktamas77/agentop/main/docs/demo.gif)
 
 ## Usage
 
@@ -29,6 +29,12 @@ npm install -g agentop
 agentop
 ```
 
+Want to see it without any agents running? Try the demo:
+
+```sh
+npx agentop --demo
+```
+
 ### Live keys
 
 | Key | Action |
@@ -46,6 +52,7 @@ agentop
 -r, --reverse          Reverse sort order
 -n, --once             Print a single snapshot and exit (no live UI)
     --json             Print agents as JSON and exit
+    --demo             Show fabricated sample agents (no real data)
     --no-color         Disable ANSI colors
 -h, --help             Show help
 -v, --version          Show version

package/bin/agentop.js

@@ -2,6 +2,7 @@
 'use strict';
 
 const { collectAgents } = require('../lib/collect');
+const { demoAgents } = require('../lib/demo');
 const { buildFrame, sortAgents, SORTS } = require('../lib/render');
 const { runLive } = require('../lib/ui');
 const c = require('../lib/colors');
@@ -14,6 +15,7 @@ function parseArgs(argv) {
     reverse: false,
     once: false,
     json: false,
+    demo: false,
     color: undefined,
   };
   const args = argv.slice(2);
@@ -59,6 +61,9 @@ function parseArgs(argv) {
       case '--reverse':
         opts.reverse = true;
         break;
+      case '--demo':
+        opts.demo = true;
+        break;
       default:
         fail(`unknown option: ${a}`);
     }
@@ -84,6 +89,8 @@ OPTIONS
   -r, --reverse          Reverse sort order
   -n, --once             Print a single snapshot and exit (no live UI)
       --json             Print agents as JSON and exit
+      --demo             Show fabricated sample agents (no real data) — handy
+                         for previews, screenshots, and demos
       --no-color         Disable ANSI colors
   -h, --help             Show this help
   -v, --version          Show version
@@ -104,15 +111,16 @@ WHAT IT SHOWS
 function main() {
   const opts = parseArgs(process.argv);
   if (opts.color === false) c.setEnabled(false);
+  const collect = opts.demo ? demoAgents : collectAgents;
 
   if (opts.json) {
-    const agents = sortAgents(collectAgents(), opts.sort, opts.reverse);
+    const agents = sortAgents(collect(), opts.sort, opts.reverse);
     process.stdout.write(JSON.stringify(agents, null, 2) + '\n');
     return;
   }
 
   if (opts.once || !process.stdout.isTTY) {
-    const agents = sortAgents(collectAgents(), opts.sort, opts.reverse);
+    const agents = sortAgents(collect(), opts.sort, opts.reverse);
     const frame = buildFrame(agents, {
       width: process.stdout.columns || 100,
       height: Math.max(agents.length + 6, 10),

package/lib/demo.js

@@ -0,0 +1,106 @@
+'use strict';
+
+// Fabricated agents for `agentop --demo` — privacy-safe, reproducible sample
+// data for screenshots, demo GIFs, and previewing the UI without running any
+// real Claude sessions. States cycle over time so the live view looks alive.
+
+const FIXTURES = [
+  {
+    pid: 50121,
+    project: 'api-gateway',
+    branch: 'main',
+    model: 'claude-opus-4-8',
+    baseCpu: 22.4,
+    rssKb: 612000,
+    uptimeSec: 4460,
+  },
+  {
+    pid: 50488,
+    project: 'web-frontend',
+    branch: 'feat/checkout',
+    model: 'claude-sonnet-4-6',
+    baseCpu: 14.1,
+    rssKb: 548000,
+    uptimeSec: 1820,
+  },
+  {
+    pid: 50733,
+    project: 'billing-service',
+    branch: 'main',
+    model: 'claude-opus-4-8',
+    baseCpu: 9.7,
+    rssKb: 503000,
+    uptimeSec: 7321,
+  },
+  {
+    pid: 51002,
+    project: 'ml-pipeline',
+    branch: 'exp/embeddings',
+    model: 'claude-opus-4-8',
+    baseCpu: 31.8,
+    rssKb: 731000,
+    uptimeSec: 980,
+  },
+  {
+    pid: 51140,
+    project: 'mobile-app',
+    branch: 'release/2.3',
+    model: 'claude-haiku-4-5',
+    baseCpu: 2.1,
+    rssKb: 421000,
+    uptimeSec: 15400,
+  },
+  {
+    pid: 51399,
+    project: 'infra-terraform',
+    branch: 'main',
+    model: 'claude-sonnet-4-6',
+    baseCpu: 0.3,
+    rssKb: 388000,
+    uptimeSec: 22030,
+  },
+];
+
+// Each rotation step: [rawState, detail, idleSec]. classifyState (in render via
+// the precomputed `state`) maps these to colors; we set `state` directly here.
+const CYCLE = [
+  { rawState: 'tool', detail: 'Bash', idleSec: 1, state: 'working' },
+  { rawState: 'tool', detail: 'Edit', idleSec: 2, state: 'working' },
+  { rawState: 'thinking', detail: '', idleSec: 3, state: 'thinking' },
+  { rawState: 'tool', detail: 'Grep', idleSec: 1, state: 'working' },
+  { rawState: 'replied', detail: 'done — opened PR #214', idleSec: 12, state: 'replied' },
+  { rawState: 'tool', detail: 'WebSearch', idleSec: 1, state: 'working' },
+  { rawState: 'replied', detail: 'awaiting input', idleSec: 95, state: 'waiting' },
+  { rawState: 'idle', detail: '', idleSec: 740, state: 'idle' },
+];
+
+// Build the demo agent list for a given timestamp (ms). Pass a fixed value for
+// deterministic output (tests); omit for a live, animated view.
+function demoAgents(nowMs = Date.now()) {
+  const tick = Math.floor(nowMs / 1000);
+  return FIXTURES.map((f, i) => {
+    const phase = CYCLE[(tick + i * 2) % CYCLE.length];
+    const cpuJitter =
+      phase.state === 'idle' || phase.state === 'waiting' ? 0 : ((tick + i) % 5) - 2;
+    return {
+      pid: f.pid,
+      cpu: Math.max(0, +(f.baseCpu + cpuJitter).toFixed(1)),
+      rssKb: f.rssKb,
+      uptimeSec: f.uptimeSec + (tick % 60),
+      cwd: `/Users/dev/${f.project}`,
+      project: f.project,
+      args: 'claude',
+      model: f.model,
+      version: '2.1.168',
+      gitBranch: f.branch,
+      sessionId: null,
+      lastPrompt: null,
+      rawState: phase.rawState,
+      detail: phase.detail,
+      idleSec: phase.idleSec,
+      state: phase.state,
+    };
+  });
+}
+
+module.exports = { demoAgents };

package/lib/ui.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const { collectAgents } = require('./collect');
+const { demoAgents } = require('./demo');
 const { buildFrame, sortAgents, SORTS } = require('./render');
 
 const ALT_ON = '\x1b[?1049h';
@@ -20,6 +21,7 @@ function runLive(opts) {
     sort: opts.sort,
     reverse: opts.reverse,
   };
+  const collect = opts.demo ? demoAgents : collectAgents;
 
   const out = process.stdout;
   out.write(ALT_ON + HIDE_CURSOR);
@@ -43,7 +45,7 @@ function runLive(opts) {
   }
 
   function draw() {
-    const agents = sortAgents(collectAgents(), state.sort, state.reverse);
+    const agents = sortAgents(collect(), state.sort, state.reverse);
     const frame = buildFrame(agents, {
       width: out.columns,
       height: out.rows,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentop",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "top, but for your running Claude Code agents — a live terminal dashboard of every Claude CLI session on your machine.",
   "keywords": [
     "claude",