Metrics Commands
status
Display current system metrics.
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.
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.
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
Service Commands
service install
Install CatOps as a system service.
Creates:
- Linux: systemd user service
- macOS: launchd agent
service start
Start the monitoring service.
service stop
Stop the monitoring service.
service remove
Uninstall the system service.
service status
Check service status.
Authentication Commands
auth login
Connect to CatOps Cloud.
catops auth login YOUR_TOKEN
auth logout
Disconnect from Cloud.
auth info
Show current authentication status.
Daemon Commands
restart
Restart the monitoring daemon.
Use after changing configuration.
start
Start monitoring in foreground (debugging).
Press Ctrl+C to stop.
Update Commands
update
Update to the latest version.
version
Show current version.
catops version
# or
catops --version
Cleanup Commands
uninstall
Remove CatOps completely.
Removes:
- Binary (
~/.local/bin/catops)
- Config (
~/.catops/)
- System service
- Log files
cleanup
Clean up old log files and cache.
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 |
