CLI Commands

Metrics Commands

status

Display current system metrics.

catops status

Shows:

CPU usage (total and per-core)
Memory usage (used/total)
Disk usage (per mount)
Network traffic
Load averages
Daemon status

processes

Show top processes by resource usage.

catops processes

Options:

Flag	Description
`--cpu`	Sort by CPU (default)
`--mem`	Sort by memory
`--limit N`	Show top N processes

AI Commands

ask

Ask AI questions about your server.

catops ask "why is CPU high?"
catops ask "what's using the most memory?"
catops ask "any issues on this server?"

Requires Cloud mode. Enable with catops auth login.

Configuration Commands

config

View current configuration.

catops config

Shows:

Collection interval
Auth status
Server ID
Config file path

set

Update configuration settings.

# Set collection interval (seconds)
catops set interval 30

# Set CPU alert threshold (%)
catops set cpu 80

# Set memory alert threshold (%)
catops set mem 85

# Set disk alert threshold (%)
catops set disk 90

Valid intervals: 10-300 seconds.

Service Commands

service install

Install CatOps as a system service.

catops service install

Creates:

Linux: systemd user service
macOS: launchd agent

service start

Start the monitoring service.

catops service start

service stop

Stop the monitoring service.

catops service stop

service remove

Uninstall the system service.

catops service remove

service status

Check service status.

catops service status

Authentication Commands

Connect to CatOps Cloud.

catops auth login YOUR_TOKEN

Get your token from catops.app/settings.

auth logout

Disconnect from Cloud.

catops auth logout

auth info

Show current authentication status.

catops auth info

Daemon Commands

restart

Restart the monitoring daemon.

catops restart

Use after changing configuration.

start

Start monitoring in foreground (debugging).

catops start

Press Ctrl+C to stop.

Update Commands

update

Update to the latest version.

catops update

version

Show current version.

catops version
# or
catops --version

Cleanup Commands

uninstall

Remove CatOps completely.

catops uninstall

Removes:

Binary (~/.local/bin/catops)
Config (~/.catops/)
System service
Log files

cleanup

Clean up old log files and cache.

catops cleanup

All Flags

Global flags available for all commands:

Flag	Description
`--help`, `-h`	Show help
`--version`, `-v`	Show version
`--config`	Custom config path
`--verbose`	Enable debug output

Getting Started

Cloud

Hub

CLI

Metrics Commands

status

processes

AI Commands

ask

Configuration Commands

config

set

Service Commands

service install

service start

service stop

service remove

service status

Authentication Commands

auth logout

auth info

Daemon Commands

restart

start

Update Commands

update

version

Cleanup Commands

uninstall

cleanup

All Flags

​Metrics Commands

​status

​processes

​AI Commands

​ask

​Configuration Commands

​config

​set

​Service Commands

​service install

​service start

​service stop

​service remove

​service status

​Authentication Commands

​auth login

​auth logout

​auth info

​Daemon Commands

​restart

​start

​Update Commands

​update

​version

​Cleanup Commands

​uninstall

​cleanup

​All Flags

Metrics Commands

status

processes

AI Commands

ask

Configuration Commands

config

set

Service Commands

service install

service start

service stop

service remove

service status

Authentication Commands

auth login

auth logout

auth info

Daemon Commands

restart

start

Update Commands

update

version

Cleanup Commands

uninstall

cleanup

All Flags