Skip to main content

smon

smon is the auto-approval helper — a session monitor that watches sessions and can approve routine permission prompts and notify a manager on events, so you don't have to answer every prompt by hand.

note

In a TDA setup, smon is usually managed automatically by the manager session. You rarely need to run it directly — this page documents the commands for when you do.

Commands​

watch​

Watch one or more sessions and notify a manager on events, optionally auto-approving routine prompts.

smon watch <sessions...> [options]

Arguments:

  • <sessions...> - Session names or patterns (supports * wildcard)

Common options:

  • -d, --daemon - Run in the background (daemon mode)
  • -n, --notify <session> - Manager session to notify (auto-detected from IST_SESSION when available)
  • -i, --interval <ms> - Polling interval in milliseconds (default: 1500)
  • -s, --strategy <type> - Entry level: gate-only, gate-then-bot (recommended), or bot-first
  • --allow <patterns...> - Runtime auto-approve regex patterns (merged with ~/.ist/smon/allow-patterns.json)
  • -v, --verbose - Verbose output
  • --dry-run - Show what would be done without acting

Additional advanced options (bot profile/CLI, circuit-breaker thresholds, idle notifications, server selection) are available via smon watch --help.

Examples:

# Watch a worker in the background
smon watch worker1 -d

# Watch all workers matching a pattern and notify the manager
smon watch 'myapp-*' -d --notify myapp-mgr

list​

List available sessions.

smon list
# alias: smon ls

prompt​

Print a session's current screen (raw prompt text) to stdout.

smon prompt <session>

status​

Show running smon instances.

smon status

stop​

Stop smon instances (scoped to the current session by default).

smon stop [target] [options]

Arguments:

  • target - PID or session name to stop

Options:

  • -a, --all - Stop all instances for the current session
  • --all-global - Stop all instances globally (dangerous — affects other sessions)

reconnect​

Reconnect smon instances to the detection server (scoped to the current session by default).

smon reconnect [pid]

allow​

Manage runtime auto-approve regex patterns.

smon allow add <pattern>
smon allow remove <pattern>
smon allow list

config​

Manage smon configuration (~/.ist/smon/config.json).

smon config set <key> <value>
smon config get <key>
smon config list

See Also​