CLI Reference

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 upstream npm package and does not include ArgentOS-specific features like the model router. Using it will produce errors on custom config 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

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

Daily Operations

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

Troubleshooting

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:

# Bash
argent completion bash >> ~/.bashrc

# Zsh
argent completion zsh >> ~/.zshrc

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

On this page