Skip to main content

​
Overview

The argent gateway commands control the always-on gateway process that manages agents, channels, and sessions.

​
Commands

​
argent gateway start

Start the gateway in the foreground:
The gateway runs in the current terminal session. Use Ctrl+C to stop. For production use, install as a system service instead.

​
argent gateway stop

Stop the running gateway:
Sends a graceful shutdown signal. Active sessions are saved before exit.

​
argent gateway restart

Restart the gateway:
Equivalent to stop followed by start. Active channel connections are re-established automatically.

​
argent gateway status

Show the current gateway status:
Output:
A healthy gateway shows “RPC probe: ok” and “Listening: *:18789”.

​
argent gateway install

Install the gateway as a system service:
  • macOS: Creates a LaunchAgent at ~/Library/LaunchAgents/ai.argent.gateway.plist
  • Linux: Creates a systemd user service
The service starts automatically on login/boot.
The plist uses the current node binary in PATH. If Homebrew’s node is first, the gateway will use it instead of nvm’s node, causing ABI mismatches with native modules. Verify the plist node path matches your nvm installation.

​
argent gateway uninstall

Remove the system service:

​
argent gateway logs

View gateway logs:

​
Service Management

If you manually edit the plist: