ArgentOSDocs

argent status

System health overview — check gateway, channels, memory, and service status at a glance.

Overview

The argent status command provides a comprehensive overview of your ArgentOS installation's health.

Usage

argent status

Output

ArgentOS Status
═══════════════════════════════════════

Gateway:
  Status:     running (PID 12345)
  RPC Probe:  ok
  Port:       18789
  Uptime:     3d 14h 22m

Channels:
  telegram    connected    @my_argent_bot
  discord     connected    ArgentBot#1234
  whatsapp    disconnected (session expired)

Agent:
  Model:      claude-sonnet-4-20250514
  Router:     enabled (4 tiers)
  Sessions:   4 active

Memory:
  Database:   ~/.argentos/memory.db
  Entries:    2,004
  Size:       14.2 MB

Auth Profiles:
  anthropic:titanium    active
  anthropic:webdevtoday active
  anthropic:semfreak    cooldown (2m remaining)
  minimax:coding-plan   active

License:
  Tier:       Pro
  Status:     active
  Expires:    2027-01-15

System:
  Node.js:    v22.22.0 (nvm)
  Platform:   darwin arm64
  Memory:     256 GB

Sections

Gateway

Shows whether the gateway process is running, the RPC probe result, listening port, and uptime.

  • RPC Probe: ok -- Gateway is healthy and responding
  • RPC Probe: failed -- Gateway is running but not responding (check logs)

Channels

Lists all configured channels with their connection status. Disconnected channels show the reason.

Agent

Current model configuration, router status, and active session count.

Memory

MemU database location, entry count, and file size.

Auth Profiles

All configured auth profiles with their current status:

  • active -- Ready for use
  • cooldown -- Rate limited, showing time remaining
  • disabled -- Manually disabled or invalid credentials

License

Current license tier, status, and expiration date.

System

Node.js version, platform information, and available memory. Useful for diagnosing compatibility issues.

JSON Output

For scripting and monitoring:

argent status --json

Returns the full status as a JSON object.

Monitoring Integration

Use the JSON output for monitoring systems:

# Check if gateway is healthy
argent status --json | jq '.gateway.rpcProbe'

# Check for channels in error state
argent status --json | jq '.channels[] | select(.status != "connected")'