astracode-agent 0.5.2 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -90,8 +90,8 @@ current folder. A request on the command line is the first message.
90
90
  pastes an image on macOS.
91
91
  - **Output.** Replies stream as they arrive. Each tool call is one line and
92
92
  each edit is shown as a diff. Ctrl-O shows full tool output, and Ctrl-T
93
- shows or hides the todo list. The footer shows the mode, the model and how
94
- much of the context is used.
93
+ shows or hides the todo list. The footer shows the mode and how much of the
94
+ context is used.
95
95
  - **Shortcuts.** `!command` runs in your shell, and its output goes with your
96
96
  next message. `# note` remembers something about this project.
97
97
 
@@ -100,7 +100,7 @@ Commands:
100
100
  | command | |
101
101
  |---|---|
102
102
  | `/clear`, `/resume` | start a new conversation, or go back to one |
103
- | `/undo`, `/rewind` | take back the last message, or go back to before an earlier one, restoring its edits too |
103
+ | `/undo`, `/rewind` | take back the last message, or go back to before an earlier one, restoring its edits and what its commands did |
104
104
  | `/compact`, `/context` | summarise the conversation to free context, or see how much is used |
105
105
  | `/model` | AstraOne: balanced, most capable, or lowest cost |
106
106
  | `/plan` | switch to plan mode |
@@ -244,6 +244,23 @@ stderr says so.
244
244
  A run that stopped short fails the job. It does not report success with an
245
245
  apology in the summary.
246
246
 
247
+ ### Undo a run
248
+
249
+ ```sh
250
+ astracode-agent undo # the last run in this folder
251
+ astracode-agent undo --list # recent runs, newest first
252
+ astracode-agent undo <run> # that one
253
+ ```
254
+
255
+ Every run that may change files, in a conversation, with `-p` or over `acp`,
256
+ takes a checkpoint before each edit and each command, kept beside the CLI's
257
+ sessions, never in the project. `undo` puts back what the run changed,
258
+ including what its commands generated, deleted or rewrote, and leaves alone,
259
+ and lists, any file that has changed again since. It prints the
260
+ `--restore <id>` that takes the undo back. `-p --output-format json` names the
261
+ run as `runId` when it changed something. `review`, read-only and plan runs
262
+ change nothing, so they have nothing to undo. Checkpoints need git on `PATH`.
263
+
247
264
  ## In GitHub Actions
248
265
 
249
266
  ```yaml
@@ -404,7 +421,7 @@ These are not available without an editor:
404
421
  - diagnostics and language-server lookups
405
422
  - the MCP servers in your settings (an agent file's own servers do start, as above)
406
423
  - the code index
407
- - memories and checkpoints
424
+ - memories
408
425
 
409
426
  Content search uses `rg` from your `PATH`. Install ripgrep for it; GitHub's
410
427
  runners already have it.