Skip to main content

​
Overview

The gateway is configured through argent.json, the main configuration file located at ~/.argentos/argent.json.

​
Configuration File

{
  "gateway": {
    "port": 18789,
    "host": "0.0.0.0",
    "auth": {
      "enabled": true,
      "token": "your-gateway-auth-token"
    }
  }
}

​
Core Settings

​
Port

The WebSocket port the gateway listens on: 
{
  "gateway": {
    "port": 18789
  }
}
Change this if port 18789 conflicts with another service.

​
Host

The interface to bind to:
  • "localhost" — Only accept local connections (default for security)
  • "0.0.0.0" — Accept connections from any interface (needed for remote access)

​
Authentication

Gateway auth prevents unauthorized access to the WebSocket API: 
{
  "gateway": {
    "auth": {
      "enabled": true,
      "token": "a-long-random-string"
    }
  }
}
When enabled, clients must include the token in the WebSocket connection handshake. Without authentication, anyone with network access to the gateway port can control your agent.

​
State Directory

The gateway stores its state in: 
~/.argentos/
  argent.json              # Main configuration
  memory.db                # MemU database
  data/
    dashboard.db           # Dashboard/tasks database
  agents/
    main/
      sessions/            # Session data
      agent/
        auth-profiles.json # Auth profiles

​
LaunchAgent Configuration (macOS)

The argent gateway install command generates a plist at: 
~/Library/LaunchAgents/ai.argent.gateway.plist
The plist uses whatever node binary is first in PATH at install time. If Homebrew’s node comes first, the gateway will use it instead of nvm’s node, causing native module ABI mismatches. Verify the node path in the plist matches your nvm installation.
To fix the node path:
1

Edit the plist

Edit ~/Library/LaunchAgents/ai.argent.gateway.plist
2

Change the node path

Update to your nvm node (e.g., /Users/you/.nvm/versions/node/v22.22.0/bin/node)
3

Reload the service

launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/ai.argent.gateway.plist
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/ai.argent.gateway.plist

​
Environment Variables

VariableDescription
ANTHROPIC_API_KEYFallback API key (auth profiles take precedence)
ARGENT_HOMEOverride state directory (default: ~/.argentos)
ARGENT_LOG_LEVELLogging level: debug, info, warn, error