Skip to main content
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:

stop

Stop the running CowAgent service.

restart

Restart the CowAgent service (stop then start).
Options:

update

Update code and restart the service. Automatically performs:
  1. Pull latest code (git pull)
  2. Stop current service
  3. Update Python dependencies
  4. Reinstall CLI
  5. 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: Examples:

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:
The cow command is recommended — it provides cleaner syntax and richer features. It is automatically installed via the one-click install script.