fix: expand reply cwd (~) and document AGENTS

This commit is contained in:
Peter Steinberger
2025-12-14 02:59:31 +00:00
parent 5ace7c9c66
commit 507f5623f4
8 changed files with 105 additions and 7 deletions

View File

@@ -6,6 +6,37 @@ read_when:
---
# AGENTS.md — Clawdis Personal Assistant (default)
## First run (recommended)
1) Create a dedicated workspace for your assistant (where it can read/write files):
```bash
mkdir -p ~/clawd
```
2) Copy this template to your workspace root as `AGENTS.md`:
```bash
cp docs/AGENTS.default.md ~/clawd/AGENTS.md
```
3) Point CLAWDIS at that workspace so Pi runs with the right context:
```json5
{
inbound: {
reply: {
cwd: "~/clawd"
}
}
}
```
## Safety defaults
- Dont dump directories or secrets into chat.
- Dont run destructive commands unless explicitly asked.
- Dont send partial/streaming replies to external messaging surfaces (only final replies).
## What Clawdis Does
- Runs WhatsApp gateway + Pi coding agent so the assistant can read/write chats, fetch context, and run tools via the host Mac.
- macOS app manages permissions (screen recording, notifications, microphone) and exposes a CLI helper `clawdis-mac` for scripts.