sam-4screen-desktop 2026-8-4:12:14:15

300 areas/350 AI/Pi Agent Extensions & Skills.md

@@ -545,7 +545,7 @@ A multi-component system for live agent visibility across all machines. Every pi
 pi session (any machine, any terminal: zellij / tmux / plain)
   └─ dashboard.ts extension
        ├─ writes ~/.pi/agent/dashboard/<session>.json   (heartbeat every 15s + on events)
-       ├─ tracks tasks → <project>/.pi/dashboard/tasks/todo.txt
+       ├─ tracks tasks → <project>/todo.txt
        └─ sends NTFY / Apprise / notify-send notifications
                                                      │ SSH pull (cat *.json)
 pi-dashboard (Go TUI on .27) ◄───────────────────────┴── .13 + .51 state dirs
@@ -572,7 +572,7 @@ pi-dashboard --help          # keybindings + config reference
 
 | You want to… | What you do | What happens |
 |---|---|---|
-| Add / list / complete tasks | Tell pi: *"add a task: …"*, *"what tasks do I have?"*, *"mark … done"* | The agent calls `register_task` / `list_tasks` / `complete_task`, which write lines to `<project>/.pi/dashboard/tasks/todo.txt` |
+| Add / list / complete tasks | Tell pi: *"add a task: …"*, *"what tasks do I have?"*, *"mark … done"* | The agent calls `register_task` / `list_tasks` / `complete_task`, which write lines to `<project>/todo.txt` at the project root |
 | See the task board | Press `Tab` in the dashboard TUI | Tuxedo opens the selected session's `todo.txt` (vim keys: `j/k`, `dd` complete, `u` undo, `s` phone QR) |
 | Review what an agent changed | Press `d` on its row in the dashboard TUI | Hunk opens in the agent's folder: `cd <cwd> && hunk diff --watch` — shows **all uncommitted changes** in that repo (not a two-file compare) |
 | Jump into a session | Press `Enter` on its row | `tmux attach` / `zellij attach` / `zellij action switch-session` |
@@ -611,7 +611,7 @@ Status labels: `● running` · `○ idle` · `⚠ blocked` · `✕ error` · `
 | `↑↓` | Select agent |
 | `Enter` | Attach: `tmux attach -t <name>` / `zellij attach <name>` (dashboard outside zellij) / `zellij action switch-session <name>` (dashboard inside zellij) — local, or over SSH for remote rows |
 | `d` | **Hunk** — review the selected agent's changes *in its own folder*: `cd <cwd> && hunk diff --watch` |
-| `Tab` | **Tuxedo** — open the selected agent's **project** task board: `<cwd>/.pi/dashboard/tasks/todo.txt` (created if missing; falls back to global board) |
+| `Tab` | **Tuxedo** — open the selected agent's **project** task board: `<cwd>/todo.txt` (created if missing; falls back to global board) |
 | `s` | Cycle sort: **smart** (live first → running first → last activity) → activity → started → folder |
 | `x` | Toggle hiding closed sessions (dead sessions sink to the bottom by default; `x` removes them from the view, press again to restore) |
 | `z` | Toggle hiding sub-agent rows (marked `◇`) |
@@ -655,7 +655,7 @@ The extension detects the `TMUX` env var: rows show `Ⓣ`, and `Enter` does `tmu
 ### Tasks & Tuxedo
 
 - Agents register tasks via the `register_task` / `complete_task` / `list_tasks` tools.
-- Task files are **per project**: `<project>/.pi/dashboard/tasks/todo.txt` (standard todo.txt format).
+- Task files are **per project**: `<project>/todo.txt` at the project root (standard todo.txt format) — visible in `ls`, easy to open, and **tracked in git** when the project is a repo: task changes are versioned (progress history) and visible to collaborators who clone the repo. (No gitignore — it's a tiny file; the only caveat is that tasks in a public/shared repo are public, so keep secrets out of task titles.)
 - In the dashboard, `Tab` opens Tuxedo on the **selected row's** project board; with nothing selected it falls back to `~/.pi/agent/dashboard/tasks/todo.txt`.
 - Tuxedo: vim keys (`j/k`, `dd`, `gg/G`), `u` undo (50 levels), `s` QR phone capture → https://github.com/webstonehq/tuxedo