From 364bd9b66fdaf79fb36bbe678e4aead0e7d03c62 Mon Sep 17 00:00:00 2001 From: Jared Vititoe Date: Wed, 7 Oct 2026 19:31:01 -0400 Subject: [PATCH] docs: README for 0.4.0 (status, file drop, Ops Alerts) Co-Authored-By: Claude Opus 5.5 --- README.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index ce8c4b0..b657266 100644 --- a/README.md +++ b/README.md @@ -33,8 +33,18 @@ The tmux server runs in its own unit, so every Claude process lives in **that** - **Rename / end:** the ✎ and × buttons on each session in the panel. Renaming keeps the session, its running Claude and its recorded conversation. Ending stops Claude; the conversation stays in Claude's history. - **Windows:** each session has a `claude` window (0) and a `shell` window (1). - **Conversation tracking:** a Claude `SessionStart` hook records each session's conversation ID in `/var/lib/devdesk/registry.json`. After a reboot the session resumes *that* conversation, even when other Claude instances, such as code-server, use the same directory. +- **Session status:** Claude hooks (`devdesk-state-hook`) mark each session **working**, **waiting on you** (with Claude's message) or **idle**. + - The sidebar shows it with context %, and the header shows the current session's state. + - A pulsing "… needs you" chip jumps to other sessions that are waiting. +- **File & image drop:** drag files onto the terminal or paste a screenshot. + - They're uploaded through ttyd to `/var/lib/devdesk/uploads//` (25 MB max, pruned after 7 days), and the path is pasted into Claude. + - For images, Claude attaches them itself. +- **Ops Alerts panel:** firing and pending Grafana alert rules, each with a link to the rule. + - **Ask Claude** types an investigation prompt into the current session without sending it. + - Configure `DEVDESK_GRAFANA_URL`, plus a Viewer token in `DEVDESK_GRAFANA_TOKEN_FILE`. +- **Repo / CI panel:** branch, ahead/behind, uncommitted changes, HEAD's Gitea CI status and open PRs for the session's folder. - **Claude Context panel:** a Claude `statusLine` command (`devdesk-statusline`) snapshots each session's model, context-window use, cost and edits to `/var/lib/devdesk/context/.json`. The panel shows the current session's numbers, and Claude's own footer shows a one-line summary. Sessions started before 0.2.0 need Claude restarted (`/exit`, then ⏎ in the menu) before they report. -- **SSH:** `devdesk attach `, `devdesk new [project]`, `devdesk rename `, `devdesk end `, `devdesk ls`, `devdesk pick`. +- **SSH:** `devdesk attach `, `devdesk new [project]`, `devdesk rename `, `devdesk end `, `devdesk ls`, `devdesk pick`, `devdesk repo `, `devdesk alerts`. ## Keys | Key | Action | @@ -74,5 +84,4 @@ CI (`.gitea/workflows/build-deb.yml`): - A `v*` tag also publishes to `https://code.lotusguild.org/api/packages/LotusGuild/debian`, creates a release, and auto-deploys to CT 126. A signed webhook runs `devdesk-deploy`, which upgrades the package; see [docs/DEPLOY.md](docs/DEPLOY.md). ## Roadmap -- **Next:** Matrix notifications when you're away (needs the Ci-Alert hookshot URL). -- **v2:** Ops Alerts (Grafana) with "Ask Claude" prompts, and file drop. +- Matrix "Claude needs you" notifications when no tab is open.