@mkhuda/agent-ps 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.6.0
+
+Reclaiming what ended sessions leave behind.
+
+- `agent-ps prune` removes the parts of an ended session that are not the
+  conversation: subagent transcripts, file history, task records, shell
+  snapshots, request dumps. On the machine it was written on that is 96M across
+  43 sessions, against 33M for deleting every session older than a month,
+  because the sessions holding the space are recent rather than old.
+- It reports by default and removes only with `--apply`. Transcripts are never
+  removed, a session with a running process is never touched whatever its age,
+  and agents that keep sessions in a database are left alone entirely.
+- `p` in the table does the same for the selected row, after a confirmation
+  naming what goes. On a running session it refuses and says why.
+- The detail panel marks which parts of a session can be pruned, and the line
+  above the keys reports the total when there is one.
+- One confirmation path now serves every destructive key, rather than each
+  growing its own.
+- Release pages take their title and notes from the changelog instead of the
+  commit list.
+
 ## 0.5.0
 
 The token counts four agents were already writing.

package/README.md

@@ -154,6 +154,7 @@ something.
 | `S` | reverse the direction |
 | `k` | stop the selected process and its children, after confirming |
 | `b` | stop every background helper, after confirming |
+| `p` | remove what the selected ended session left behind, after confirming |
 | `y`, `n` | answer a confirmation |
 | `e` | show or hide ended sessions |
 | `/` | filter by session, title, agent, model, directory, or PID |
@@ -239,6 +240,9 @@ agent-ps list --all               # include ended sessions
 agent-ps list --json              # machine readable, with idle seconds
 agent-ps list --limit 100         # how many ended sessions (default 40)
 agent-ps list --filter benchmark  # same match as the / key
+agent-ps prune                    # what ended sessions left, minus the conversation
+agent-ps prune --older-than 30d   # only sessions idle that long (default 7d)
+agent-ps prune --apply            # actually remove it
 agent-ps agents                   # which agents were found, and where
 agent-ps --agent codex list       # one agent, or a comma separated list
 agent-ps stop 32244               # stop one process tree
@@ -253,6 +257,30 @@ agent-ps --version
 Piping works without a subcommand: with stdout not a terminal, agent-ps prints
 the table and exits.
 
+## Reclaiming space
+
+A session writes more than its conversation. Claude Code alone keeps subagent
+transcripts, file history for `/rewind`, task records and a session
+environment, and on this machine those came to a fifth of everything on disk.
+
+```bash
+agent-ps prune
+```
+
+Reports and removes nothing. It lists what ended sessions left behind, grouped
+by what it is and which sessions hold the most, and `--apply` removes it.
+
+In the table, `p` does the same for the row you are on, and the detail panel
+marks which parts of a session those are. On a session that is still running it
+refuses and says why rather than going quiet.
+
+Three things it will not do. It never touches a transcript, so every session
+stays resumable. It never touches a session with a running process, whatever
+its age, because file history is what `/rewind` reaches for. And it never
+touches OpenCode, Copilot or Antigravity, whose sessions are rows in a database
+the agent may have open: agent-ps reads, and does not write, the stores it
+did not create.
+
 ## What each column means
 
 | Column | Meaning |
@@ -348,7 +376,7 @@ install fetches. The build is reproducible: the same source always produces the
 same bytes, so the committed executable can be checked against the tree.
 
 ```
-d46f6f55086b25c4efab962d2945e70c2c486aa62931cf6e532cec2c16174496  agent-ps
+b57e60c153471ce8a5630d72a2688633b7d6ff9c5359b372e12fc03d0d9379d9  agent-ps
 ```
 
 Adding an agent takes one class and one line in the registry. See

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mkhuda/agent-ps",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A process table for coding agent sessions. Claude Code, Codex, OpenCode, Hermes, Pi, CommandCode and Copilot in one view, with models, idle time, disk use and one key to stop them.",
   "keywords": [
     "cli",