lcode-cli 0.2.2__tar.gz → 0.3.0__tar.gz

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/CHANGELOG.md

@@ -6,6 +6,18 @@ All notable changes to lcode are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-09-30
+
+### Added
+
+- `/undo` takes back the file changes of the last request: lcode saves a checkpoint before the model
+  first changes files in a request, and restores edited and deleted files and removes new ones,
+  including changes made by shell commands. `/undo` again goes further back, `/rewind N` goes back
+  to before request N (optionally removing those requests from the conversation too), and
+  `/checkpoints` lists them. Checkpoints live in a separate git repository in lcode's state folder,
+  so your own repository is never touched, and work in folders that aren't git repositories.
+  Turn them off with `lcode config set checkpoints false`.
+
 ## [0.2.2] - 2026-09-30
 
 ### Added
@@ -116,7 +128,8 @@ First public release.
 - `AGENTS.md` project instructions and `/init` to generate them.
 - One-line installer for Linux and macOS.
 
-[Unreleased]: https://github.com/nasser1941/lcode/compare/v0.2.2...HEAD
+[Unreleased]: https://github.com/nasser1941/lcode/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/nasser1941/lcode/compare/v0.2.2...v0.3.0
 [0.2.2]: https://github.com/nasser1941/lcode/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/nasser1941/lcode/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/nasser1941/lcode/compare/v0.1.2...v0.2.0

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: lcode-cli
-Version: 0.2.2
+Version: 0.3.0
 Summary: A local-first terminal coding agent powered by open-weight models on your own GPU or Mac, via Ollama.
 Project-URL: Homepage, https://nasser1941.github.io/lcode/
 Project-URL: Documentation, https://nasser1941.github.io/lcode/
@@ -76,6 +76,8 @@ through [Ollama](https://ollama.com), and when it needs current information it c
   largest context that fits: `lcode setup` does it in one step.
 - **Safe by default.** Every edit is shown as a diff and every command that isn't read-only needs
   your approval. `auto-edit` and `yolo` modes when you want speed.
+- **Undo.** lcode saves a checkpoint before the model changes files; `/undo` takes back the last
+  request's edits, new files and shell-command changes, without touching your git history.
 - **Bring your own model.** Eight curated open-weight models, all tested end to end, or any Ollama model
   with tool calling.
 - **Web search when needed.** Looks up the latest versions, docs and error messages with Ollama web
@@ -123,6 +125,7 @@ lcode
 | `lcode -c` / `lcode --resume` | continue the last session here / pick a saved session from a list |
 | `lcode --model qwen3.5-9b --context 128k` | pick a model and context window for this session |
 | `lcode models` / `lcode doctor` | what fits this machine / check the installation |
+| `/undo`, `/rewind` | take back the last request's file changes, or go back further |
 | `/rename`, `/resume` | name the current session, resume a saved one |
 | `/model`, `/context`, `/compact`, `/help` | switch model, resize the context window (pick from a list), summarize, list commands |
 
@@ -167,7 +170,6 @@ fills up. Details: [How it works](https://nasser1941.github.io/lcode/how-it-work
 
 See the pinned [Roadmap issue](https://github.com/nasser1941/lcode/issues/10). Next up:
 
-- [`/undo` and automatic checkpoints](https://github.com/nasser1941/lcode/issues/4)
 - [`lcode bench`: score models on your own hardware](https://github.com/nasser1941/lcode/issues/5)
 - [MCP tool servers](https://github.com/nasser1941/lcode/issues/6)
 - [Homebrew formula](https://github.com/nasser1941/lcode/issues/8) and an [optional sandbox for shell commands](https://github.com/nasser1941/lcode/issues/9)

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/README.md

@@ -43,6 +43,8 @@ through [Ollama](https://ollama.com), and when it needs current information it c
   largest context that fits: `lcode setup` does it in one step.
 - **Safe by default.** Every edit is shown as a diff and every command that isn't read-only needs
   your approval. `auto-edit` and `yolo` modes when you want speed.
+- **Undo.** lcode saves a checkpoint before the model changes files; `/undo` takes back the last
+  request's edits, new files and shell-command changes, without touching your git history.
 - **Bring your own model.** Eight curated open-weight models, all tested end to end, or any Ollama model
   with tool calling.
 - **Web search when needed.** Looks up the latest versions, docs and error messages with Ollama web
@@ -90,6 +92,7 @@ lcode
 | `lcode -c` / `lcode --resume` | continue the last session here / pick a saved session from a list |
 | `lcode --model qwen3.5-9b --context 128k` | pick a model and context window for this session |
 | `lcode models` / `lcode doctor` | what fits this machine / check the installation |
+| `/undo`, `/rewind` | take back the last request's file changes, or go back further |
 | `/rename`, `/resume` | name the current session, resume a saved one |
 | `/model`, `/context`, `/compact`, `/help` | switch model, resize the context window (pick from a list), summarize, list commands |
 
@@ -134,7 +137,6 @@ fills up. Details: [How it works](https://nasser1941.github.io/lcode/how-it-work
 
 See the pinned [Roadmap issue](https://github.com/nasser1941/lcode/issues/10). Next up:
 
-- [`/undo` and automatic checkpoints](https://github.com/nasser1941/lcode/issues/4)
 - [`lcode bench`: score models on your own hardware](https://github.com/nasser1941/lcode/issues/5)
 - [MCP tool servers](https://github.com/nasser1941/lcode/issues/6)
 - [Homebrew formula](https://github.com/nasser1941/lcode/issues/8) and an [optional sandbox for shell commands](https://github.com/nasser1941/lcode/issues/9)

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/SECURITY.md

@@ -37,6 +37,8 @@ user, in your working directory**. It is not a sandbox. Keep in mind:
   snippets from your code. Use `web = ask` to approve each search, or `web = off` / `--no-web` to
   keep everything local.
 - Sessions (including file contents the model read) are stored in `~/.local/state/lcode/sessions`.
+  Checkpoints for `/undo` keep copies of your project's files (except ignored ones) in
+  `~/.local/state/lcode/checkpoints` for 14 days; turn them off with `checkpoints = false`.
 
 Reports about bypassing the permission prompts, the read-only allowlist, or data leaving the
 machine unexpectedly are especially welcome.

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/docs/configuration.md

@@ -25,6 +25,7 @@ lcode config path                      # print the file location
 | `web` | `on` | Web search and page fetching: `on`, `ask` (before each search/website) or `off` |
 | `search_backend` | `auto` | `auto`, `ollama`, `brave`, `tavily` or `searxng`; `auto` uses the first one configured |
 | `searxng_url` | | Your SearXNG instance, e.g. `http://localhost:8888` |
+| `checkpoints` | `true` | Save a checkpoint before the model changes files, so [`/undo`](usage.md#undo-and-checkpoints) can restore them |
 
 Example file:
 
@@ -58,6 +59,7 @@ Environment variables override the file, which is useful for one-off runs and CI
 | `~/.config/lcode/config.toml` | Settings |
 | `~/.local/state/lcode/sessions/` | Saved conversations (for `lcode -c`) |
 | `~/.local/state/lcode/history` | Prompt history (++up++ in the prompt) |
+| `~/.local/state/lcode/checkpoints/` | Checkpoints for `/undo` (copies of your project's files; deleted after 14 days) |
 | `~/.local/state/lcode/limits.json` | Context sizes that ran out of GPU memory on this machine (safe to delete) |
 
 Sessions contain everything the model read, including file contents. Delete the folder to clear them.

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/docs/how-it-works.md

@@ -75,6 +75,7 @@ the Ollama server you configure, it only contacts the web when the model searche
 | `agent.py` | System prompt, streaming, tool loop, compaction, sessions |
 | `tools.py` | Tool schemas and implementations |
 | `permissions.py` | Approval prompts and the read-only allowlist |
+| `checkpoints.py` | Snapshots before the model changes files, for `/undo` and `/rewind` |
 | `catalog.py`, `models.toml` | Model catalog and memory estimates |
 | `hardware.py` | NVIDIA / Apple Silicon detection |
 | `ollama.py` | Ollama HTTP client |

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/docs/index.md

@@ -67,7 +67,7 @@ until the task is done, asking before it changes anything.
     ---
 
     Every edit is shown as a diff and every non-read-only command needs your approval, unless you
-    choose otherwise.
+    choose otherwise. `/undo` takes back a request's file changes.
 
 -   :material-swap-horizontal:{ .lg .middle } **Bring your own model**
 

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/docs/quickstart.md

@@ -12,7 +12,7 @@ lcode
 
 ```text
 ╭──────────────────────────────────────────────╮
-│ lcode v0.2.2 — local coding agent            │
+│ lcode v0.3.0 — local coding agent            │
 │                                              │
 │ model    lcode-qwen3.6-35b                   │
 │ context  256K tokens                         │

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/docs/usage.md

@@ -49,6 +49,9 @@ reasoning is on.
 | `/clear` | Start a new conversation (the current one stays saved) |
 | `/rename NAME` | Name the current session so it's easy to find later |
 | `/resume [SESSION]` | Resume a saved session: pick from a list, or give its number or name; `/resume all` lists every folder |
+| `/undo` | Undo the file changes of the last request ([details](#undo-and-checkpoints)) |
+| `/rewind [N]` | Go back to before request N: its files, and optionally the conversation |
+| `/checkpoints` | List the requests that changed files, and which files |
 | `/compact [focus]` | Summarize the conversation to free context |
 | `/context [size]` | Show how full the context window is and change its size: pick from a list with memory estimates, or give a size like `/context 128k` (`/ctx` is a shortcut) |
 | `/model [name]`, `/models` | Switch model, list models |
@@ -97,6 +100,38 @@ or ++n++. Text after ++n++ goes to the model as instructions: `n run the tests w
     In `yolo` mode the model can run any command as your user. Use it in a container, a VM or a
     throwaway clone, not on a machine with data you care about.
 
+## Undo and checkpoints
+
+Before the model first changes anything in a request (an edit, a new file, or a shell command that
+isn't read-only), lcode saves a checkpoint of your project. If the result isn't what you wanted,
+`/undo` puts the files back:
+
+```text
+❯ /undo
+Undoing request 3: switch the parser to the new tokenizer
+  restore src/parser.py
+  restore tests/test_parser.py
+  remove  src/tokenizer_v2.py
+Done: restored src/parser.py, tests/test_parser.py; removed src/tokenizer_v2.py.
+```
+
+- `/undo` again goes one more request back. The model is told which files were restored, so it
+  reads them again instead of assuming its changes are still there.
+- `/checkpoints` lists the requests that changed files. `/rewind 2` goes back to before request 2
+  in one step (undoing every request after it too) and offers to remove those requests from the
+  conversation as well.
+- Changes made by shell commands are covered too (`sed -i`, generated files, `rm`), in any folder,
+  whether or not it's a git repository.
+- If you edited one of those files yourself after the model did, lcode lists it and asks before
+  going back, since that would lose your edit. Files the model didn't touch are never changed.
+
+Checkpoints are stored in a separate git repository under `~/.local/state/lcode/checkpoints/`. Your
+own repository (its index, branches, stash and history) is never touched. Ignored files (per
+`.gitignore`), `node_modules`, virtual environments and files over 10 MB aren't included. Folders
+with more than 20,000 files, or your home folder itself, aren't checkpointed; lcode says so once and
+carries on. Checkpoints are deleted after 14 days. To turn them off:
+`lcode config set checkpoints false`.
+
 ## Web search
 
 When the answer depends on information newer than the model's training data, such as the latest

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/src/lcode/__init__.py

@@ -1,3 +1,3 @@
 """lcode — a local-first terminal coding agent powered by open-weight models via Ollama."""
 
-__version__ = "0.2.2"
+__version__ = "0.3.0"

{lcode_cli-0.2.2 → lcode_cli-0.3.0}/src/lcode/agent.py

@@ -19,6 +19,7 @@ from rich.panel import Panel
 from rich.text import Text
 
 from lcode import catalog, limits, sessions, web
+from lcode.checkpoints import Checkpoints
 from lcode.config import format_tokens
 from lcode.ollama import Ollama, OllamaError
 from lcode.permissions import Permissions
@@ -136,6 +137,7 @@ class Settings:
     web: str = "on"  # on | ask | off
     search_backend: str = "auto"
     searxng_url: str | None = None
+    checkpoints: bool = True  # snapshot files before the model changes them, for /undo
 
 
 class Agent:
@@ -147,6 +149,7 @@ class Agent:
         self.perms = Permissions(self.console, settings.permission_mode)
         self.tools = Toolbox(self)
         self.session_id = self.new_session_id()
+        self.checkpoints = Checkpoints(self.console, settings.checkpoints)
         self.session_name = ""
         self.session_title = ""
         self.ctx_used = 0
@@ -220,6 +223,7 @@ class Agent:
             "name": self.session_name,
             "title": self.session_title,
             "messages": self.messages,
+            "checkpoints": self.checkpoints.to_json(),
         }
         f.write_text(json.dumps(data))
 
@@ -228,6 +232,7 @@ class Agent:
         self.session_id = self.new_session_id()
         self.session_name = ""
         self.session_title = ""
+        self.checkpoints.reset(self.session_id)
 
     def rename(self, name: str) -> None:
         self.session_name = " ".join(name.split())
@@ -249,6 +254,7 @@ class Agent:
                 note = f"The session's directory {saved_cwd} no longer exists; staying in {self.cwd}"
         self.messages = [{"role": "system", "content": self.system_prompt()}, *data.get("messages", [])[1:]]
         self.session_id = info.id
+        self.checkpoints.load(info.id, data.get("checkpoints") or [])
         self.session_name = data.get("name", "")
         self.session_title = data.get("title") or sessions.title_from(self.messages)
         self.tools.read_mtimes.clear()  # files may have changed since; the model must read them again
@@ -406,6 +412,17 @@ class Agent:
         return name
 
     def run_turn(self, user_text: str) -> None:
+        self.checkpoints.begin_turn(self.session_id, user_text, len(self.messages))
+        try:
+            self._run_turn(user_text)
+        finally:
+            self.checkpoints.end_turn()
+
+    def checkpoint(self) -> None:
+        """Called before the model changes files: snapshot them once per request, for /undo."""
+        self.checkpoints.before_change(self.cwd)
+
+    def _run_turn(self, user_text: str) -> None:
         self.messages.append({"role": "user", "content": self.expand_mentions(user_text)})
         malformed = 0
         for _ in range(MAX_STEPS_PER_TURN):