lcode-cli 0.33.1__tar.gz → 0.34.0__tar.gz

{lcode_cli-0.33.1 → lcode_cli-0.34.0}/CHANGELOG.md

@@ -6,6 +6,24 @@ All notable changes to lcode are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.34.0] - 2026-10-14
+
+### Added
+
+- Screenshots without a screen: a `screenshot` tool runs a desktop program or opens a web page the
+  way you would see it, saves the shot in `.lcode/screenshots/`, and returns what it shows with the
+  sizes behind it. For a Python Qt program, that's each window against the screen, the size its
+  layout needs, and the widgets that stick out or overlap. For a web page or a local server
+  (headless Chrome), it's the page's size, what scrolls sideways, and the console errors and
+  failed requests. Other desktop programs run on a virtual display (Xvfb). See
+  [Screenshots](https://nasser1941.github.io/lcode/usage/#screenshots).
+
+### Fixed
+
+- In a project with a virtual environment (`.venv`, `venv` or `env`), the model is told to run its
+  Python (`.venv/bin/python`) rather than plain `python`, which lacks the project's packages. Found
+  when the model checked a PySide6 app with the system Python, failed, and stopped checking.
+
 ## [0.33.1] - 2026-10-14
 
 ### Changed
@@ -722,7 +740,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.33.1...HEAD
+[Unreleased]: https://github.com/nasser1941/lcode/compare/v0.34.0...HEAD
+[0.34.0]: https://github.com/nasser1941/lcode/compare/v0.33.1...v0.34.0
 [0.33.1]: https://github.com/nasser1941/lcode/compare/v0.33.0...v0.33.1
 [0.33.0]: https://github.com/nasser1941/lcode/compare/v0.32.0...v0.33.0
 [0.32.0]: https://github.com/nasser1941/lcode/compare/v0.31.0...v0.32.0

{lcode_cli-0.33.1 → lcode_cli-0.34.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: lcode-cli
-Version: 0.33.1
+Version: 0.34.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/

{lcode_cli-0.33.1 → lcode_cli-0.34.0}/docs/quickstart.md

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

{lcode_cli-0.33.1 → lcode_cli-0.34.0}/docs/usage.md

@@ -106,6 +106,7 @@ reasoning is on.
 | `web_search` | Search the web for current information (needs a [search provider](#web-search)) |
 | `web_fetch` | Read a web page or text file by URL as clean text |
 | `view_image` | Look at an image: a model that can see describes it ([Images](#images)) |
+| `screenshot` | Run a desktop program or open a web page without a screen, and see it with its sizes ([Screenshots](#screenshots)) |
 | `agent` | Hand a task to a [subagent](agents.md) with its own context; only its report comes back |
 | `memory` | Save, update or delete [notes](memory.md) that later sessions load |
 | `repo_map` | The [repository map](search.md): important files, classes and functions, ranked (larger repositories; small ones get it in the instructions) |
@@ -342,6 +343,43 @@ Loading a second model takes a moment: on a 12 GB GPU, describing an image with
 `qwen3.6:35b-a3b-coding` takes about a minute, and the next request reloads the main model. Turn
 image support off with `lcode config set vision_model off`.
 
+## Screenshots
+
+Layout bugs are invisible in the code: a window bigger than the screen, panels cut off, a page that
+scrolls sideways. With the `screenshot` tool the model runs the program, or opens the page, without
+a screen and sees what you would, measured:
+
+```text
+● screenshot(python camera_wall.py)
+  ⎿ .lcode/screenshots/20261014-120211-camera-wall.png (Qt offscreen (PyQt6), 1366x768 screen)
+```
+
+```text
+- Window "Camera Wall" (CameraWall): 1362x764 at (0, 0)
+  Its layout needs at least 1950x984, more than the screen has
+  Sticks out of the window: Panel #panel-4: 640x480 at (9, 385)
+  Overlap (190x480): Panel #panel-1: 640x480 at (9, 9) and Panel #panel-2: 640x480 at (459, 9)
+```
+
+| What | How | Besides the picture |
+|---|---|---|
+| A Python Qt program (PyQt5/6, PySide2/6) | Qt's offscreen platform, on a screen of the size asked for (Qt 6) | Each window's size and position, the size its layout needs, widgets that stick out or overlap |
+| Any other desktop program (Linux) | A virtual display, Xvfb | The size and position of each window |
+| A web page, an `.html` file or a local server | Headless Chrome, Chromium or Edge (Firefox takes the picture only) | The page's size against the window and what sticks out sideways, console errors, failed requests |
+
+- For a web app, the model gives the command that starts the server and the page's URL: lcode
+  starts the server, waits for the page to answer, takes the shot and stops the server.
+- A model that can see describes the picture with the model's question in mind (see
+  [Which model looks](#images)). Without one, the measurements still come back.
+- Shots are saved in `.lcode/screenshots/` in the project, which keeps itself out of git, so you
+  can look too.
+- Running a program asks for permission like any command. A web page that isn't local follows the
+  `web` setting. With the [sandbox](sandbox.md) on, programs can't be shown, since they don't run on
+  your machine.
+- Needs: Xvfb for other desktop programs (`sudo apt install xvfb x11-apps`), and Chrome or
+  Chromium for web pages. On macOS only Qt programs and web pages work, since there's no virtual
+  display.
+
 ## Permissions
 
 | Mode | File edits | Shell commands |

{lcode_cli-0.33.1 → lcode_cli-0.34.0}/src/lcode/__init__.py

@@ -3,7 +3,7 @@
 From a program: `from lcode import Session` (see lcode.api).
 """
 
-__version__ = "0.33.1"
+__version__ = "0.34.0"
 
 API = ("Session", "Result", "Options", "SetupError")
 

{lcode_cli-0.33.1 → lcode_cli-0.34.0}/src/lcode/agent.py

@@ -48,7 +48,7 @@ from lcode.config import format_tokens
 from lcode.jobs import Jobs
 from lcode.mcp import McpManager
 from lcode.ollama import Ollama, OllamaError
-from lcode.permissions import Permissions
+from lcode.permissions import LEADING_CD, Permissions
 from lcode.render import MarkdownStreamer
 from lcode.repeats import Repeats
 from lcode.sandbox import Sandbox, SandboxError, project_root
@@ -122,7 +122,7 @@ SYSTEM_PROMPT = """You are lcode, an autonomous software-engineering agent runni
 # Verifying your work
 - A syntax check or an import only shows that code loads. Run what you changed the way it will be used (the script, the tests, the app) and fix what fails.
 - To fix a bug, first reproduce each problem the user reports with a test, a command or a short script, then run the same checks to show they're gone.
-- For what you can't see, like a GUI, a web page or a layout, check it without a screen where you can: `QT_QPA_PLATFORM=offscreen` for Qt, a headless browser, or a script that prints sizes and positions or renders to an image{look}. Measure instead of assuming.
+- For what you can't see, like a GUI, a web page or a layout, use the screenshot tool: it runs the program (or opens the page) without a screen and returns what it shows, with the sizes of windows, widgets or the page measured{look}. Measure instead of assuming.
 - Never claim something works, mark a todo done, or call it tested unless you ran it. If you couldn't check something, say so and tell the user exactly what to look for. If something fails, say so and show the relevant error.{checks}
 
 # Communication
@@ -131,7 +131,7 @@ SYSTEM_PROMPT = """You are lcode, an autonomous software-engineering agent runni
 
 # Environment
 - Working directory: {cwd}
-- OS: {os}; shell: bash; Python command: `{python}`
+- OS: {os}; shell: bash; Python command: {python}
 - Date: {date}
 - Git: {git}
 
@@ -218,6 +218,30 @@ def call_arguments(call: dict) -> dict:
     return args if isinstance(args, dict) else {}
 
 
+VENV_DIRS = (".venv", "venv", "env")
+
+
+def project_python(cwd: Path) -> Path | None:
+    """The project's virtual environment's Python (.venv, venv or env, here or up to the repository's root)."""
+    for folder in [cwd, *cwd.parents][:4]:
+        for name in VENV_DIRS:
+            path = folder / name / "bin" / "python"
+            if path.exists() and (folder / name / "pyvenv.cfg").exists():
+                return path
+        if (folder / ".git").exists():
+            break  # not beyond the repository
+    return None
+
+
+def python_line(cwd: Path) -> str:
+    """How the system prompt names the Python command."""
+    venv = project_python(cwd)
+    if venv is None:
+        return f"`{'python' if shutil.which('python') else 'python3'}`"
+    shown = venv.relative_to(cwd) if cwd in venv.parents else venv
+    return f"`{shown}` (the project's virtual environment: plain python lacks its packages)"
+
+
 class Progress:
     """The status line under a running request.
 
@@ -372,7 +396,7 @@ class Agent:
             model=self.settings.model,
             cwd=self.cwd,
             os=f"{platform.system()} {platform.release()} ({platform.machine()})",
-            python="python" if shutil.which("python") else "python3",
+            python=python_line(self.cwd),
             date=dt.date.today().isoformat(),
             git=git_info(self.cwd),
             tree=tree(self.cwd, depth=1, limit=120),
@@ -383,7 +407,7 @@ class Agent:
             skills=extensions.skills_prompt(self.extensions().skills, self.settings.context),
             code=self.code_prompt(),
             map=self.map_prompt(),
-            look=" you look at with view_image" if self.vision_model() else "",
+            look="; look at other images with view_image" if self.vision_model() else "",
             checks=self.checks_prompt(),
         )
 
@@ -1000,6 +1024,9 @@ class Agent:
             return f"agent({args.get('type', '')}: {args.get('description') or str(args.get('task', ''))[:50]})"
         if name == "bash":
             return f"$ {str(args.get('command', ''))[:60]}"
+        if name == "screenshot":
+            what = args.get("url") or LEADING_CD.sub("", str(args.get("command") or ""))
+            return f"screenshot({what[:60]})"
         if name in ("web_search", "web_fetch", "view_image"):
             return f"{name}({args.get('query') or args.get('url') or args.get('path') or ''})"
         if self.mcp and self.mcp.owns(name):