detector-agent
detector-agent captures your local tmux sessions and sends them to the hosted detection service. It is the backend that powers session detection, auto-approval, and the web dashboard.
You sign in once, then start it — it connects automatically and detects all IST sessions (sessions starting with ist--).
Getting Started
# 1. Sign in (Google) — required first
detector-agent login
# 2. Start as a background daemon
detector-agent start
A valid login is required before start. In most setups you only need detector-agent login once — the rest runs automatically in the background.
Commands
login
Sign in (Google). Required before start.
detector-agent login
logout
Sign out and clear stored credentials.
detector-agent logout
whoami
Show the currently logged-in user.
detector-agent whoami
start
Start the daemon in the background.
detector-agent start
stop
Stop the running daemon.
detector-agent stop
restart
Restart the daemon.
detector-agent restart
status
Show daemon status.
detector-agent status
attach
Stop the daemon and restart it in the foreground.
detector-agent attach
rescan
Force a rescan of sessions (signals the running agent).
detector-agent rescan
sync
Sync unregistered sessions only (re-registers missing sessions).
detector-agent sync
config
Manage persistent server configuration (get / set-servers / add-mirror / remove-mirror / use-mode / unset).
detector-agent config <subcommand>
Running detector-agent with no command runs it in the foreground and auto-detects all ist-- sessions.
Options
-i, --instance <name>- Instance name for PID isolation (allows multiple agents)--poll-interval <ms>- Polling interval in milliseconds (default:200)--token-tracking- Enable token tracking
Example:
# Stop a named instance
detector-agent stop --instance dev
See Also
smon- Auto-approval helper that builds on session detection- Installation - One-time monitoring login during setup