Gateway Configuration

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:

Edit the plist

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

Change the node path

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

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

Variable	Description
`ANTHROPIC_API_KEY`	Fallback API key (auth profiles take precedence)
`ARGENT_HOME`	Override state directory (default: `~/.argentos`)
`ARGENT_LOG_LEVEL`	Logging level: debug, info, warn, error

Web UI

Dashboard

Tasks

Gateway & Ops

Intent & Safety

Security

Overview

Configuration File

Core Settings

Port

Host

Authentication

State Directory

LaunchAgent Configuration (macOS)

Environment Variables

​Overview

​Configuration File

​Core Settings

​Port

​Host

​Authentication

​State Directory

​LaunchAgent Configuration (macOS)

​Environment Variables

Overview

Configuration File

Core Settings

Port

Host

Authentication

State Directory

LaunchAgent Configuration (macOS)

Environment Variables