stalker-config

Agent Stalker — Configuration

Config file location

The config file is AGENT_STALKER_CONFIG_PATH if that env var is set, otherwise <home>/.claude/agent-stalker.config.json (home = $HOME or %USERPROFILE%). Resolve the real home directory — do not write a literal ~.

Its shape (matches lib/config.ts):

{
  "contentRules": { "Bash": { "maxLength": 2000 }, "Read": "metadata", "Edit": "full" },
  "pausedPaths": ["/abs/path/to/project"],
  "ui": { "host": "127.0.0.1", "allowedHosts": [] }
}

A contentRules value is "full", "metadata", or { "maxLength": <n> }. Preserve any existing keys when editing — read the file, merge, write it back.

The ui section controls the dashboard server: host is the bind address (default 127.0.0.1; set 0.0.0.0 to allow LAN access) and allowedHosts lists extra hostnames the dashboard may be browsed at (e.g. ["office-pc"] for http://office-pc:3141 — IPs and localhost always work).

Note: the default capture rule for Edit and Write is now metadata (file contents not stored). set Edit full restores full capture.

Behavior

Manage the config file above. Interpret the user's argument:

• show (or no argument) — read and display the current config file. If it does not exist, show the defaults below.
• set <tool> <rule> — update the config file:
  • set Bash full — store full content for Bash
  • set Read metadata — metadata only for Read
  • set Bash maxLength 2000 — truncate Bash at 2000 chars
• reset — delete the config file to restore defaults.
• pause — add the current working directory to pausedPaths. Print Paused tracking for <cwd>.
• resume — remove the current working directory from pausedPaths. Print Resumed tracking for <cwd>; if it was not paused, print Tracking was not paused for <cwd>.
• status — report whether the current working directory is in pausedPaths (tracking active vs paused for this project).

The current working directory is available from the session context.

Default content rules

Tool	Rule
Edit, Write	metadata
Read, Glob, Grep	metadata
Bash	maxLength 2000
default (everything else)	maxLength 500

Notes

• Content rules control how much of each tool's input/output is stored (full text, metadata only, or truncated to N chars). They do not affect which events are tracked.
• pausedPaths suppresses tracking for sessions whose working directory matches a paused path.