Runtime operations
signet status
Section titled “signet status”Show comprehensive status of the Signet installation.
signet statussignet status --path /custom/pathOptions:
| Option | Description |
|---|---|
-p, --path <path> |
Custom base path |
Output:
◈ signet v0.1.0 own your agent. bring it anywhere.
Status
● Daemon running PID: 12345 Uptime: 2h 15m Dashboard: http://localhost:3850
✓ AGENTS.md ✓ agent.yaml ✓ memories.db
Memories: 42 Conversations: 7
Path: /home/user/.agentssignet dashboard
Section titled “signet dashboard”Open the Signet web dashboard in your default browser.
signet dashboardsignet ui # AliasOptions:
| Option | Description |
|---|---|
-p, --path <path> |
Custom base path |
If the daemon is not running, it will be started automatically.
signet route
Section titled “signet route”Inspect and control the shared inference router. Requires the daemon to be
running for list, status, doctor, explain, and test.
signet route listsignet route statussignet route doctorsignet route explain "fix this bun test" --agent rose --task-class hard_codingsignet route test "summarize this transcript" --agent dot --task-class casual_chat --timeout 60000signet route pin opus/opus46 --agent rose --task-class hard_codingsignet route unpin --agent rose --task-class hard_codingSubcommands:
| Command | Description |
|---|---|
signet route list |
List router config plus runtime health |
signet route status |
Show configured targets, policies, and workload bindings |
signet route doctor |
Report broken or unavailable route targets |
signet route explain <prompt> |
Dry-run a route decision and print the trace |
signet route test <prompt> |
Execute a real prompt through the router |
signet route pin <targetRef> |
Write a hard pin into agent.yaml |
signet route unpin |
Remove a hard pin from agent.yaml |
Common options:
| Option | Description |
|---|---|
--agent <agent> |
Agent id override |
--task-class <taskClass> |
Task-class override |
--operation <operation> |
Routing operation kind |
--privacy <privacy> |
Privacy tier override |
--policy <policy> |
Explicit policy override |
--target <targetRef> |
Explicit target pin for the current request |
--timeout <ms> |
Request timeout for route test, up to 600000 ms |
--refresh |
Re-check target health before routing |
--debug |
Print the full routing decision trace |
--json |
Emit raw JSON |
Pins are stored under routing.agents.<agent>.pinnedTargets in
$SIGNET_WORKSPACE/agent.yaml.
Daemon Commands
Section titled “Daemon Commands”Daemon operations live under the signet daemon subcommand group. The
top-level shortcuts still exist as backwards-compatible aliases, but the
grouped form is the preferred surface.
signet daemon startsignet daemon stopsignet daemon restartsignet daemon statussignet daemon logs
# Backwards-compatible aliasessignet startsignet stopsignet restartsignet logssignet daemon start
Section titled “signet daemon start”Start the Signet daemon if not already running.
◈ signet v0.1.0 own your agent. bring it anywhere.
✔ Daemon started Dashboard: http://localhost:3850Top-level alias: signet start
signet daemon stop
Section titled “signet daemon stop”Stop the running Signet daemon.
Top-level alias: signet stop
signet daemon restart
Section titled “signet daemon restart”Stop and start the daemon. Useful after installing an update.
Top-level alias: signet restart
signet daemon logs
Section titled “signet daemon logs”View daemon logs.
signet daemon logssignet daemon logs -n 100signet daemon logs --followsignet daemon logs --level warnsignet daemon logs --category memoryTop-level alias: signet logs
Options:
| Option | Description |
|---|---|
-n, --lines <n> |
Number of lines to show (default: 50) |
-f, --follow |
Follow log output in real-time |
-l, --level <level> |
Filter by level: debug, info, warn, error |
-c, --category <category> |
Filter by category: daemon, api, memory, sync, git, watcher |
Service Installation
Section titled “Service Installation”The daemon can be installed as a system service (systemd on Linux, launchd on macOS) using the daemon package’s bun scripts:
cd platform/daemonbun run install:service # Install as systemd/launchd servicebun run uninstall:service # Remove the serviceThese are package-level scripts, not top-level signet CLI commands.
They register a unit that starts the daemon automatically at login.
signet update
Section titled “signet update”Check for updates, install them manually, or configure unattended
auto-installs. Use an explicit subcommand such as signet update check.
signet update check # check for updatessignet update check --forcesignet update installsignet update statussignet update enablesignet update enable --interval 3600signet update disableSubcommands:
| Command | Description |
|---|---|
signet update check |
Check if a newer version is available |
signet update install |
Download and install the latest version |
signet update status |
Show auto-update settings and last result |
signet update enable |
Enable unattended background installs |
signet update disable |
Disable unattended background installs |
signet update check options:
| Option | Description |
|---|---|
-f, --force |
Force a fresh check, ignoring cached result |
signet update enable options:
| Option | Description |
|---|---|
-i, --interval <seconds> |
Check interval in seconds (default: 21600; range: 300-604800) |
After signet update install completes, a daemon restart is required to
run the new version: signet daemon restart. When a direct native install
coexists with an npm/Bun/pnpm/Yarn wrapper, the updater uses the native binary
instead of selecting a package manager from PATH. The CLI prints an exact
command that removes only the duplicate launcher after the update; signet doctor reports the same conflict. Do not uninstall the whole package, because
it may also provide signet-mcp. Signet never removes the duplicate
automatically.
signet bypass
Section titled “signet bypass”Toggle per-session hook bypass. When bypass is enabled for a session, all Signet hooks return empty no-op responses — the daemon is still running, but it stays silent for that session. MCP tools (memory_search, memory_store, etc.) continue to work normally.
signet bypass # List active sessions with bypass statussignet bypass --list # Same as abovesignet bypass <session-key> # Enable bypass for a sessionsignet bypass --off <session-key> # Disable bypass for a sessionSubcommands:
| Command | Description |
|---|---|
signet bypass |
List active sessions and their bypass status |
signet bypass --list |
Same as signet bypass with no arguments |
signet bypass <session-key> |
Enable bypass for the given session |
signet bypass --off <session-key> |
Disable bypass for the given session |
You can also bypass hooks entirely at the process level using the
SIGNET_BYPASS environment variable (see below).