> ## 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.

# CLI Reference

> All available argent CLI commands for managing your ArgentOS installation.

## Overview

The `argent` CLI is the primary interface for managing your ArgentOS installation. It handles gateway management, channel configuration, memory operations, and system status.

## Installation

The CLI is installed automatically during setup:

```bash theme={null}
npx argentos init
```

After installation, the `argent` command is available in your PATH.

<Warning>
  Always use `argent` (not `openclaw`). The `openclaw` command is the legacy OpenClaw CLI, which is incompatible with ArgentOS. It does not support ArgentOS-specific features like the model router, intent governance, or execution worker, and will produce errors on ArgentOS configuration keys.
</Warning>

## Command Groups

| Group                                  | Description                                 |
| -------------------------------------- | ------------------------------------------- |
| [`argent gateway`](/cli/gateway-cmd)   | Start, stop, and manage the gateway service |
| [`argent channels`](/cli/channels-cmd) | Add, remove, and configure channels         |
| [`argent memory`](/cli/memory-cmd)     | Search and manage agent memory              |
| [`argent status`](/cli/status-cmd)     | System health overview                      |
| `argent setup`                         | Initial configuration wizard                |
| `argent license`                       | License management                          |
| `argent tasks`                         | Task management                             |
| `argent config`                        | Configuration management                    |
| `argent dashboard`                     | Open the web dashboard                      |
| `argent marketplace`                   | Browse and install packages                 |

## Global Options

| Flag              | Description                 |
| ----------------- | --------------------------- |
| `--help`          | Show help for a command     |
| `--version`       | Show ArgentOS version       |
| `--verbose`       | Increase log output         |
| `--config <path>` | Use alternative config file |

## Common Workflows

<Tabs>
  <Tab title="First-Time Setup">
    ```bash theme={null}
    npx argentos init    # Install
    argent setup         # Configure API keys
    argent gateway start # Start the gateway
    argent channels add telegram  # Connect a channel
    ```
  </Tab>

  <Tab title="Daily Operations">
    ```bash theme={null}
    argent status           # Check system health
    argent gateway logs -f  # Monitor activity
    argent tasks list       # View tasks
    argent memory search "query"  # Search memory
    ```
  </Tab>

  <Tab title="Troubleshooting">
    ```bash theme={null}
    argent gateway status   # Check gateway
    argent config validate  # Validate config
    argent gateway restart  # Restart gateway
    argent gateway logs     # View logs
    ```
  </Tab>
</Tabs>

## Tab Completion

Enable tab completion for your shell:

<CodeGroup>
  ```bash Bash theme={null}
  argent completion bash >> ~/.bashrc
  ```

  ```bash Zsh theme={null}
  argent completion zsh >> ~/.zshrc
  ```

  ```bash Fish theme={null}
  argent completion fish > ~/.config/fish/completions/argent.fish
  ```
</CodeGroup>