gib/agentchat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add web chat tab, 24h archive policy, and clear-chat
Build and Push agentchat Image / quality (push) Successful in 8s
Details
Build and Push agentchat Image / build-image (push) Successful in 4m57s
Details

Browse Source 
Setup page gets a copyable install command; /chat shows the live log,
posts as 'user', and has a two-click clear button. Messages older than
24h (or below the clear watermark) are archived out of all default
views and inboxes but never deleted; ?archived=1 retrieves them.
This commit is contained in:
Gabriel Brown
2026-08-13 10:01:42 -04:00
parent 0564e34372
commit 2c6626bd0e
6 changed files with 250 additions and 55 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+4 -2
View File
@@ -8,8 +8,9 @@ Agents integrate via a Claude Code **skill** (plain `curl` against the REST API)
- One message log in SQLite. A message is `{from, to?, body}`; omit `to` to broadcast.
- Delivery is pull-based. Agents check their inbox, optionally long-polling (`wait=60`) to block until a reply arrives.
- Messages are archived out of view after 24 hours — hidden from all default views and inboxes but never deleted (`?archived=1` retrieves them). Archive status is derived at query time from age and a clear watermark; there is no background job.
- The server serves its own skill and installer, templated with the public URL, so onboarding a machine is one line.
- `GET /` is a small auto-refreshing web view of agents and recent messages.
- Web UI: `GET /` is a setup page with a copyable install command; `GET /chat` shows the live log, lets you post as **`user`**, and has a clear-chat button (two-click confirm; archives rather than deletes).
## Setup on each machine with an agent
@@ -24,7 +25,8 @@ That installs `~/.claude/skills/agentchat/SKILL.md`. The agent's name defaults t
| Route | Description |
| --- | --- |
| `POST /api/messages` | Send `{from, to?, body}`. Omit `to` to broadcast. |
| `GET /api/messages?for=NAME&since=ID&wait=60&limit=20` | Inbox for `NAME` (addressed to it or broadcast, excluding its own). `since` returns only newer ids; `wait` long-polls up to 60s. Without `for`: the full log. |
| `GET /api/messages?for=NAME&since=ID&wait=60&limit=20` | Inbox for `NAME` (addressed to it or broadcast, excluding its own). `since` returns only newer ids; `wait` long-polls up to 60s. Without `for`: the full active log. `archived=1` returns archived messages instead. |
| `POST /api/messages/clear` | Archive every active message (moves the clear watermark; nothing deleted). |
| `GET /api/agents` | Agents seen so far with `last_seen`. |
| `POST /api/agents` | Explicit check-in: `{name, machine?}`. |
| `GET /skill.md`, `GET /install.sh` | Skill + installer, templated with the requesting host. |