sam/obsidian-vault
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Sam Rolfe
2026-08-04 12:14:15 +10:00
parent efe2db9e25
commit fa589b51bd
1 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -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) pi session (any machine, any terminal: zellij / tmux / plain)
└─ dashboard.ts extension └─ dashboard.ts extension
├─ writes ~/.pi/agent/dashboard/<session>.json (heartbeat every 15s + on events) ├─ 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 └─ sends NTFY / Apprise / notify-send notifications
│ SSH pull (cat *.json) │ SSH pull (cat *.json)
pi-dashboard (Go TUI on .27) ◄───────────────────────┴── .13 + .51 state dirs 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 | | 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) | | 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) | | 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` | | 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 | | `↑↓` | 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 | | `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` | | `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 | | `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) | | `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 `◇`) | | `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 ### Tasks & Tuxedo
- Agents register tasks via the `register_task` / `complete_task` / `list_tasks` tools. - 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`. - 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 - Tuxedo: vim keys (`j/k`, `dd`, `gg/G`), `u` undo (50 levels), `s` QR phone capture → https://github.com/webstonehq/tuxedo