astracode-agent 0.5.1 → 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
@@ -15,6 +15,18 @@ It works on macOS and Linux, on arm64 and x64. It checks the download's
15
15
  checksum, and on a Mac also checks that AstraCode signed it. To update, run
16
16
  `astracode-agent update`, which runs the same installer for the latest version.
17
17
 
18
+ On Windows, x64 or arm64, in PowerShell:
19
+
20
+ ```powershell
21
+ irm https://astracode.io/install.ps1 | iex
22
+ ```
23
+
24
+ That puts `astracode-agent.exe` in `%USERPROFILE%\.local\bin`, checks the
25
+ download's checksum, and adds the folder to your user PATH, with no
26
+ administrator rights. `$env:ASTRACODE_VERSION` pins a version and
27
+ `$env:ASTRACODE_BIN_DIR` picks another folder, as they do for `install.sh`.
28
+ `astracode-agent update` runs this installer on Windows.
29
+
18
30
  With Homebrew, on macOS or Linux:
19
31
 
20
32
  ```bash
@@ -78,8 +90,8 @@ current folder. A request on the command line is the first message.
78
90
  pastes an image on macOS.
79
91
  - **Output.** Replies stream as they arrive. Each tool call is one line and
80
92
  each edit is shown as a diff. Ctrl-O shows full tool output, and Ctrl-T
81
- shows or hides the todo list. The footer shows the mode, the model and how
82
- 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.
83
95
  - **Shortcuts.** `!command` runs in your shell, and its output goes with your
84
96
  next message. `# note` remembers something about this project.
85
97
 
@@ -88,7 +100,7 @@ Commands:
88
100
  | command | |
89
101
  |---|---|
90
102
  | `/clear`, `/resume` | start a new conversation, or go back to one |
91
- | `/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 |
92
104
  | `/compact`, `/context` | summarise the conversation to free context, or see how much is used |
93
105
  | `/model` | AstraOne: balanced, most capable, or lowest cost |
94
106
  | `/plan` | switch to plan mode |
@@ -232,6 +244,23 @@ stderr says so.
232
244
  A run that stopped short fails the job. It does not report success with an
233
245
  apology in the summary.
234
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
+
235
264
  ## In GitHub Actions
236
265
 
237
266
  ```yaml
@@ -392,7 +421,7 @@ These are not available without an editor:
392
421
  - diagnostics and language-server lookups
393
422
  - the MCP servers in your settings (an agent file's own servers do start, as above)
394
423
  - the code index
395
- - memories and checkpoints
424
+ - memories
396
425
 
397
426
  Content search uses `rg` from your `PATH`. Install ripgrep for it; GitHub's
398
427
  runners already have it.