CLI Reference - ArgentOS Docs

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:

npx argentos init

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

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.

Command Groups

Group	Description
`argent gateway`	Start, stop, and manage the gateway service
`argent channels`	Add, remove, and configure channels
`argent memory`	Search and manage agent memory
`argent status`	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

First-Time Setup
Daily Operations
Troubleshooting

npx argentos init    # Install
argent setup         # Configure API keys
argent gateway start # Start the gateway
argent channels add telegram  # Connect a channel

argent status           # Check system health
argent gateway logs -f  # Monitor activity
argent tasks list       # View tasks
argent memory search "query"  # Search memory

argent gateway status   # Check gateway
argent config validate  # Validate config
argent gateway restart  # Restart gateway
argent gateway logs     # View logs

Tab Completion

Enable tab completion for your shell:

argent completion bash >> ~/.bashrc

argent completion zsh >> ~/.zshrc

argent completion fish > ~/.config/fish/completions/argent.fish