Process management commands control the CowAgent background process. These commands are only available in the terminal.
start
Start the CowAgent service. Runs as a background daemon by default and automatically tails logs.
Options:
| Option | Description |
|---|
-f, --foreground | Run in foreground, not as a background daemon |
--no-logs | Don’t tail logs after starting |
stop
Stop the running CowAgent service.
restart
Restart the CowAgent service (stop then start).
Options:
| Option | Description |
|---|
--no-logs | Don’t tail logs after restart |
update
Update code and restart the service. Automatically performs:
- Pull latest code (
git pull)
- Stop current service
- Update Python dependencies
- Reinstall CLI
- Start service
If git pull fails (e.g., uncommitted local changes), the update aborts and the service remains unaffected.
status
Check CowAgent service status, including process info, version, and current model/channel configuration.
logs
View service logs.
Options:
| Option | Description | Default |
|---|
-f, --follow | Continuously tail log output | No |
-n, --lines | Show last N lines | 50 |
# View last 100 lines
cow logs -n 100
# Continuously tail logs
cow logs -f
install-browser
Install Playwright and Chromium browser for the browser tool.
Only needed when using browser tools (web browsing, screenshots, etc.).
run.sh Compatibility
If Cow CLI is not installed, you can use run.sh to manage the service:
| cow command | run.sh equivalent |
|---|
cow start | ./run.sh start |
cow stop | ./run.sh stop |
cow restart | ./run.sh restart |
cow update | ./run.sh update |
cow status | ./run.sh status |
cow logs | ./run.sh logs |
The cow command is recommended — it provides cleaner syntax and richer features. It is automatically installed via the one-click install script.
