agent-usage-manager 0.2.2__tar.gz → 0.2.4__tar.gz

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-usage-manager
-Version: 0.2.2
+Version: 0.2.4
 Summary: htop for AI agents — liveness, CPU/mem/GPU usage, and a kill switch for headless agents (openclaw, hermes, ollama, vllm, claude-code).
 Project-URL: Homepage, https://github.com/minglong51/agent-usage-manager
 Project-URL: Repository, https://github.com/minglong51/agent-usage-manager
@@ -19,14 +19,14 @@ Description-Content-Type: text/markdown
 
 # agent-usage-manager
 
-A tiny, single-file web dashboard for **headless AI agents** running on a machine —
+A small web dashboard for **headless AI agents** running on a machine —
 OpenClaw, Hermes, Claude Code, Ollama, vLLM, llama.cpp, or anything you name. It
 shows which agents are alive and what they're costing you (CPU, memory, GPU), and
 gives you a **kill button** per agent. Think `htop`, scoped to just your agents —
 the [screenshot below](docs/dashboard.png) is a real run on a fleet node.
 
 No database, no auth framework (one static token file gates the kill switch),
-no dependencies beyond FastAPI + psutil. Runs on macOS and Linux. It is a
+four direct dependencies (FastAPI, uvicorn, psutil, PyYAML). Runs on macOS and Linux. It is a
 per-node monitor and guarded local control panel: fleet schedulers may consume
 its read-only telemetry, but should own their own scheduling and actuation.
 
@@ -161,6 +161,15 @@ This is the important part — a web page that can kill processes needs guardrai
 
 ## Limits & known issues
 
+- **Matching is a heuristic and it over-matches.** An agent's identity usually
+  lives in its arguments (`node .../bin/codex`), and a GUI agent's real name is
+  its `.app` bundle (Kiro launches a binary called `Electron`) — so the match
+  target is the executable basename plus the first few args plus the bundle
+  name. The cost is that anything living inside an agent's `.app` (updaters,
+  crash handlers, helpers) and any process that names an agent in its first
+  args (`tmux attach -t workspace-claude`) can be misclassified as that agent.
+  `ignore:` is the escape hatch. The bundled list is not exhaustive and can't
+  be — every new agent ships new helpers under its own name.
 - **GPU column is NVIDIA-only.** Per-process GPU memory comes from
   `nvidia-smi --query-compute-apps` — NVIDIA compute processes (CUDA), in
   practice on Linux. AMD/Intel GPUs aren't read, graphics-only workloads don't
@@ -365,7 +374,24 @@ SIGTERM/SIGKILL on POSIX and TerminateProcess on Windows.
 
 ## Release notes
 
-### 0.2.2 — unreleased
+### 0.2.4 — stop reporting non-agents
+
+- `ignore:` now covers Sparkle's `Autoupdate`/`Updater` (Codex.app's equivalent of
+  Squirrel's ShipIt), the "Codex for Chrome" extension host, and `tmux attach`
+  clients — a session named `workspace-claude` matched the claude pattern via the
+  `-t` argument.
+- Dogfooded against `ps` on a live 10-agent fleet: 22 rows → 17, with all six
+  removals confirmed as not agents and every real agent retained.
+
+### 0.2.3 — startup fixes
+
+- The browser now opens once the port actually accepts, instead of on a fixed
+  1s timer. A cold `uvx` run outran the timer and landed on connection-refused.
+- No more `/favicon.ico` 404.
+- Dropped two inaccurate README claims ("single-file"; "no dependencies beyond
+  FastAPI + psutil" — there are four).
+
+### 0.2.2 — telemetry identity and fleet labels
 
 - Added `api_version` and `aum_version` to `/api/agents` and `list --json`.
 - Added per-agent `create_time` so external telemetry consumers can pair it with

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.4}/README.md

@@ -1,13 +1,13 @@
 # agent-usage-manager
 
-A tiny, single-file web dashboard for **headless AI agents** running on a machine —
+A small web dashboard for **headless AI agents** running on a machine —
 OpenClaw, Hermes, Claude Code, Ollama, vLLM, llama.cpp, or anything you name. It
 shows which agents are alive and what they're costing you (CPU, memory, GPU), and
 gives you a **kill button** per agent. Think `htop`, scoped to just your agents —
 the [screenshot below](docs/dashboard.png) is a real run on a fleet node.
 
 No database, no auth framework (one static token file gates the kill switch),
-no dependencies beyond FastAPI + psutil. Runs on macOS and Linux. It is a
+four direct dependencies (FastAPI, uvicorn, psutil, PyYAML). Runs on macOS and Linux. It is a
 per-node monitor and guarded local control panel: fleet schedulers may consume
 its read-only telemetry, but should own their own scheduling and actuation.
 
@@ -142,6 +142,15 @@ This is the important part — a web page that can kill processes needs guardrai
 
 ## Limits & known issues
 
+- **Matching is a heuristic and it over-matches.** An agent's identity usually
+  lives in its arguments (`node .../bin/codex`), and a GUI agent's real name is
+  its `.app` bundle (Kiro launches a binary called `Electron`) — so the match
+  target is the executable basename plus the first few args plus the bundle
+  name. The cost is that anything living inside an agent's `.app` (updaters,
+  crash handlers, helpers) and any process that names an agent in its first
+  args (`tmux attach -t workspace-claude`) can be misclassified as that agent.
+  `ignore:` is the escape hatch. The bundled list is not exhaustive and can't
+  be — every new agent ships new helpers under its own name.
 - **GPU column is NVIDIA-only.** Per-process GPU memory comes from
   `nvidia-smi --query-compute-apps` — NVIDIA compute processes (CUDA), in
   practice on Linux. AMD/Intel GPUs aren't read, graphics-only workloads don't
@@ -346,7 +355,24 @@ SIGTERM/SIGKILL on POSIX and TerminateProcess on Windows.
 
 ## Release notes
 
-### 0.2.2 — unreleased
+### 0.2.4 — stop reporting non-agents
+
+- `ignore:` now covers Sparkle's `Autoupdate`/`Updater` (Codex.app's equivalent of
+  Squirrel's ShipIt), the "Codex for Chrome" extension host, and `tmux attach`
+  clients — a session named `workspace-claude` matched the claude pattern via the
+  `-t` argument.
+- Dogfooded against `ps` on a live 10-agent fleet: 22 rows → 17, with all six
+  removals confirmed as not agents and every real agent retained.
+
+### 0.2.3 — startup fixes
+
+- The browser now opens once the port actually accepts, instead of on a fixed
+  1s timer. A cold `uvx` run outran the timer and landed on connection-refused.
+- No more `/favicon.ico` 404.
+- Dropped two inaccurate README claims ("single-file"; "no dependencies beyond
+  FastAPI + psutil" — there are four).
+
+### 0.2.2 — telemetry identity and fleet labels
 
 - Added `api_version` and `aum_version` to `/api/agents` and `list --json`.
 - Added per-agent `create_time` so external telemetry consumers can pair it with

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.4}/agent_usage_manager/agents.yaml

@@ -57,6 +57,10 @@ ignore:
   - crashpad      # chrome_crashpad_handler — the bundle's crash reporter
   - shipit        # Squirrel.framework auto-updater
   - kiro-cli-term # Kiro's integrated-terminal shells (zsh), not the agent
+  - autoupdate    # Sparkle's Autoupdate helper — Codex.app's ShipIt equivalent
+  - updater       # Sparkle's Updater.app; argv[1] is the app path, so it matches
+  - for chrome    # "Codex for Chrome" extension host, not the agent
+  - tmux attach   # tmux clients: `attach -t <session>` carries the agent's name
 
 # Optional: per-instance labels from tmux session names. A fleet of identical
 # agents (e.g. several claude-code bots, one per tmux session bot-*) all hit

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.4}/agent_usage_manager/cli.py

@@ -3,7 +3,9 @@ from __future__ import annotations
 import argparse
 import ipaddress
 import os
+import socket
 import threading
+import time
 import webbrowser
 
 
@@ -25,6 +27,23 @@ def _bind_allowed(host: str, unsafe_expose: bool) -> bool:
         return False
 
 
+def _open_when_ready(url: str, host: str, port: int, timeout: float = 15.0) -> None:
+    """Open the browser only once the port accepts, never on a fixed delay.
+
+    A cold first run (uvx resolving the env, then importing fastapi/uvicorn)
+    outruns any guess, and the browser lands on connection-refused. On timeout
+    we stay silent: the URL is already on stdout.
+    """
+    deadline = time.monotonic() + timeout
+    while time.monotonic() < deadline:
+        try:
+            with socket.create_connection((host, port), timeout=0.25):
+                webbrowser.open(url)
+                return
+        except OSError:
+            time.sleep(0.1)
+
+
 def _dur(s: float) -> str:
     s = max(0, int(s))
     d, h, m = s // 86400, s % 86400 // 3600, s % 3600 // 60
@@ -128,7 +147,9 @@ def main() -> None:
     print(f"agent-usage-manager → {url}")
 
     if not args.no_browser:
-        threading.Timer(1.0, lambda: webbrowser.open(url)).start()
+        threading.Thread(
+            target=_open_when_ready, args=(url, open_host, args.port), daemon=True
+        ).start()
 
     uvicorn.run("agent_usage_manager.app:app", host=args.host, port=args.port)
 

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.4}/agent_usage_manager/static/index.html

@@ -3,6 +3,7 @@
 <head>
 <meta charset="utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
+<link rel="icon" href="data:," />
 <title>agent usage manager</title>
 <style>
   :root { color-scheme: dark; }

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agent-usage-manager"
-version = "0.2.2"
+version = "0.2.4"
 description = "htop for AI agents — liveness, CPU/mem/GPU usage, and a kill switch for headless agents (openclaw, hermes, ollama, vllm, claude-code)."
 readme = "README.md"
 license = { text = "MIT" }

{agent_usage_manager-0.2.2 → agent_usage_manager-0.2.4}/uv.lock

@@ -8,7 +8,7 @@ resolution-markers = [
 
 [[package]]
 name = "agent-usage-manager"
-version = "0.2.2"
+version = "0.2.4"
 source = { editable = "." }
 dependencies = [
     { name = "fastapi", version = "0.128.8", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },