| # Examples & Recipes |
|
|
| Real things people do with mona-agent. Copy, adapt, enjoy. |
|
|
| ## Check on your machine from your phone |
|
|
| 1. `mona-agent start` on the machine (or install the launchd/systemd unit |
| from [examples/](../examples)). |
| 2. Open <https://agent.mona.expert/dashboard> on your phone. |
| 3. Chat: *"How's the disk looking?"* — the agent reads `df -h`, and the |
| dashboard shows live CPU/memory sparklines. |
|
|
| ## Morning briefing with cron |
|
|
| Get a daily summary of your home server in your dashboard before coffee: |
|
|
| ```cron |
| # ~/.config/cron.d/mona (or: crontab -e) |
| 30 7 * * * $HOME/.local/bin/mona-agent chat "Summarize disk usage, uptime and any failed systemd units." |
| ``` |
|
|
| The reply lands in the dashboard chat history, timestamped. |
|
|
| ## Watchdog — alert when a service dies |
|
|
| Ask the agent every 10 minutes; it pings the service and only reports |
| problems (the cloud keeps the conversation context): |
|
|
| ```cron |
| */10 * * * * $HOME/.local/bin/mona-agent chat "Check nginx is answering on :80. Only reply if something is wrong." |
| ``` |
|
|
| ## Nightly log cleanup |
|
|
| ```cron |
| 10 3 * * * $HOME/.local/bin/mona-agent exec "find ~/logs -name '*.log' -mtime +14 -delete && echo cleaned" |
| ``` |
|
|
| ## Health check from any shell |
|
|
| ```bash |
| mona-agent connect # force a connection test: health, auth, agents |
| ``` |
|
|
| `connect` reports cloud reachability, key validity and the agent list — |
| ideal for install verification and support tickets. |
|
|
| ## Drive a script from the dashboard |
|
|
| Anything you can put in a script, the agent can run it for you: |
|
|
| ```bash |
| #!/usr/bin/env bash |
| # backup.sh — daily offsite backup, called from the dashboard chat |
| tar czf - ~/projects | gpg -c --batch --passphrase-file ~/.backup-pass -o /mnt/backup/projects.tgz.gpg |
| ``` |
|
|
| Say *"run backup.sh"* in the chat; the guarded shell executes it and |
| streams the result back to your browser. |
|
|
| ## Headless Raspberry Pi companion |
|
|
| The agent runs on any Node.js 20+ box: |
|
|
| ```bash |
| curl -fsSL https://agent.mona.expert/install.sh | bash |
| mona-agent login |
| mona-agent start # survives reboots via the systemd unit in examples/ |
| ``` |
|
|
| Then manage the Pi from the dashboard: temperature, storage, running |
| services — with live metrics and chat. |
|
|
| ## More |
|
|
| - [INTEGRATIONS.md](INTEGRATIONS.md) — the cloud REST API and scheduling |
| - [TOOLS.md](TOOLS.md) — the built-in tool sandbox |
| - [examples/](../examples) — launchd & systemd units, health check script |
|
|
