| 1 | # In-Chat Commands |
| 2 | |
| 3 | These commands work inside chat channels and interactive agent sessions: |
| 4 | |
| 5 | | Command | Description | |
| 6 | |---------|-------------| |
| 7 | | `/new` | Stop current task and start a new conversation | |
| 8 | | `/stop` | Stop the current task | |
| 9 | | `/restart` | Restart the bot | |
| 10 | | `/status` | Show bot status | |
| 11 | | `/dream` | Run Dream memory consolidation now | |
| 12 | | `/dream-log` | Show the latest Dream memory change | |
| 13 | | `/dream-log <sha>` | Show a specific Dream memory change | |
| 14 | | `/dream-restore` | List recent Dream memory versions | |
| 15 | | `/dream-restore <sha>` | Restore memory to the state before a specific change | |
| 16 | | `/help` | Show available in-chat commands | |
| 17 | |
| 18 | ## Periodic Tasks |
| 19 | |
| 20 | The gateway wakes up every 30 minutes and checks `HEARTBEAT.md` in your workspace (`~/.nanobot/workspace/HEARTBEAT.md`). If the file has tasks, the agent executes them and delivers results to your most recently active chat channel. |
| 21 | |
| 22 | **Setup:** edit `~/.nanobot/workspace/HEARTBEAT.md` (created automatically by `nanobot onboard`): |
| 23 | |
| 24 | ```markdown |
| 25 | ## Periodic Tasks |
| 26 | |
| 27 | - [ ] Check weather forecast and send a summary |
| 28 | - [ ] Scan inbox for urgent emails |
| 29 | ``` |
| 30 | |
| 31 | The agent can also manage this file itself — ask it to "add a periodic task" and it will update `HEARTBEAT.md` for you. |
| 32 | |
| 33 | > **Note:** The gateway must be running (`nanobot gateway`) and you must have chatted with the bot at least once so it knows which channel to deliver to. |
| 34 |