agent-radar

Reviewed at commit e0195c6 New version, not yet reviewed

One live line above the prompt per running subagent: time, tool count and what it's doing. /radar shows every agent and its messages.

Made by
Hamza Zafar
What we checked

Shows one live line above the prompt per running subagent or background shell command: model, elapsed time, tool count and what it is doing. /radar opens a pane with each subagent's recent messages or a command's last output lines. It makes no network calls and sends nothing off your machine.

Review details

Static review of the source at the pinned commit; not run. Registers session.start (registers /radar, starts a 1 s clock and a 5 s poll), agent.spawn, tool.call (counts tool calls of subagents and stores a short label, for Bash only the program name; for background Bash calls it records the command's output file path), turn.complete (toast when a subagent ends), command.run for radar and ui.render for the band and the pane. For background Bash commands it takes the output file path from the tool result (absolute, ending in .output, no control characters or ..) and every 5 s runs lsof -Fn (or, on Linux without lsof, an sh script listing /proc/*/fd) to see whether the file is still open, plus a fixed sh script that runs tail -c 16384 on those files to show the last lines in the pane; terminal escape sequences and control characters are stripped before display. Reads the optional band order file claude-code-mods/bands.json under CLAUDE_CONFIG_DIR or ~/.claude (HOME) once per session. Uses $.session.messages and $.agent.list to show agent messages. Stores state only in plugin atoms; writes no files. New since the previous review: the shell-command tracking (lsof, /proc, tail), the model name display, the band ordering and the cleaning of displayed text. Command lines are not stored or shown, only the program name or the Bash description.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: no
  • Shows something on screen: yes
Hooked events
Screenshot of agent-radar

One live line above the prompt per running subagent or background shell: its model, time, tool count and what it's doing. /radar shows every agent and its messages.

Made this mod? Add a badge to your README

modsforClaude badge for agent-radar

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/agent-radar.svg)](https://modsforclaude.com/mods/agent-radar/)

← All mods