> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={null}
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

<AccordionGroup>
  <Accordion title="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)
  </Accordion>

  <Accordion title="Channels">
    Lists all configured channels with their connection status. Disconnected channels show the reason.
  </Accordion>

  <Accordion title="Agent">
    Current model configuration, router status, and active session count.
  </Accordion>

  <Accordion title="Memory">
    MemU database location, entry count, and file size.
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="License">
    Current license tier, status, and expiration date.
  </Accordion>

  <Accordion title="System">
    Node.js version, platform information, and available memory. Useful for diagnosing compatibility issues.
  </Accordion>
</AccordionGroup>

## JSON Output

For scripting and monitoring:

```bash theme={null}
argent status --json
```

Returns the full status as a JSON object.

## Monitoring Integration

Use the JSON output for monitoring systems:

```bash theme={null}
# 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")'
```