File size: 2,414 Bytes
1d3594f | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 | # 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
|