Agent Buzzwords

Small Node CLI for counting keyword occurrences across local agent/harness logs.

Usage

npx agent-buzzwords@latest

Run without arguments to open the interactive terminal UI:

npx agent-buzzwords@latest

Or install/link it locally:

npm install
npm link
agent-buzzwords error sandbox approval

Interactive controls:

Up/Down or j/k  Move selection
Space           Toggle a harness
Enter           Continue
A               Select all harnesses
C               Use custom root paths
Q or Esc        Quit

By default it scans Codex:

$CODEX_HOME/sessions

If CODEX_HOME is not set, it uses:

~/.codex/sessions

Harness Presets

Use --harness to scan other local AI coding harnesses:

agent-buzzwords --harness opencode error retry
agent-buzzwords --harness claude smoke probe
agent-buzzwords --harness cursor,gemini-cli "rate limit"
agent-buzzwords --harness antigravity-cli --ignore-case timeout
agent-buzzwords --harness all TODO FIXME

Supported presets:

codex
claude / claude-code / claude-desktop
opencode
cursor
gemini / gemini-cli
antigravity / antigravity-cli / antigravity-ide / ag / ag-ide
pi

Documented primary roots used by these presets include:

Codex:       $CODEX_HOME/sessions
Claude:      ~/.claude, ~/.claude/projects, ~/.claude.json,
             plus app/log roots such as ~/Library/Application Support/Claude
             or %APPDATA%\Claude
OpenCode:    ~/.local/share/opencode
Gemini CLI:  ~/.gemini/tmp and ~/.gemini/history
Antigravity: ~/.gemini/antigravity-cli, ~/.gemini/antigravity,
             and IDE user data such as ~/Library/Application Support/Antigravity IDE/User
             or %APPDATA%\Antigravity IDE\User
Pi:          ~/.pi/agent/sessions and ~/.pi/agent/sessions-archive
Cursor:      local Cursor user-data roots such as ~/Library/Application Support/Cursor/User,
             ~/.config/Cursor/User, or %APPDATA%\Cursor\User

Print the current list:

agent-buzzwords --list-harnesses

Include archived sessions:

agent-buzzwords --include-archived error sandbox

Search a specific directory or file:

agent-buzzwords --root ~/.codex/sessions/2026/06 "rate limit" approval

Case-insensitive matching:

agent-buzzwords --ignore-case TODO fixme

Auto-pick the most common meaningful words:

agent-buzzwords --auto
agent-buzzwords --harness all --auto --auto-limit 8
agent-buzzwords --harness codex auto

JSON output:

agent-buzzwords --json error approval

The scanner reads text-like files such as .json, .jsonl, .log, .md, .txt, .yaml, and .pbtxt. Binary databases are skipped unless the harness also writes readable JSON/log files alongside them.

In a real terminal, table output shows an animated scan panel with live counts. Disable it when you want calm output:

NO_ANIMATION=1 agent-buzzwords error approval

Animation is automatically disabled for --json and piped/non-TTY output.

Development

npm test
node ./bin/buzzwords.js --help