Task: add a probe for a new agent or a new OS

View as Markdown Open in Claude (claude.ai) Open in ChatGPT (chatgpt.com)

Goal

A read-only script that prints the processes, terminals, open files and session folders of one agent on Linux and macOS (unix.sh) or Windows (windows.ps1).

Inputs

Steps

  1. Copy the probe of a similar agent, for example probes/agy/unix.sh.
  2. Change the header line, the process pattern, and the state folders.
  3. Keep the rules of probes/README.md: read only, no conversation text, numbered sections, not found for an empty section, exit 0.
  4. Use only the helpers of probes/lib.sh or probes/lib.ps1 to read processes and files. A helper hides values that can be private.
  5. Run the probe on a machine with no session of the agent. Each section must print not found or data.
  6. Run sh tools/check-probe-output.sh <probe> <output>.
  7. Add the agent to pattern_of, state_dirs and agents in probes/run.sh (and the map in probes/run.ps1).
  8. Add a row to the table in probes/README.md.
  9. Commit with feat: add the <agent> probe for <os>. Open a pull request. The probes workflow runs it on all runner types.

Done when

The probes workflow passes on Linux, macOS and Windows.