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

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

@@ -6,6 +6,38 @@ 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
+
+- A new logo, on GitHub, PyPI and the docs site (header, favicon, home page and link previews),
+  with a light version for dark backgrounds. `scripts/make_logos.py` makes every size from the
+  original.
+
+### Fixed
+
+- The README's images and links work on PyPI: the logo, the demo and the links to the license
+  and contributing guide were relative, so PyPI showed them broken.
+- The source package is half the size (0.6 MB): it no longer carries the docs' images.
+
 ## [0.33.0] - 2026-10-14
 
 ### Added
@@ -708,7 +740,9 @@ 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.0...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
 [0.31.0]: https://github.com/nasser1941/lcode/compare/v0.30.0...v0.31.0

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: lcode-cli
-Version: 0.33.0
+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/
@@ -35,11 +35,12 @@ Requires-Dist: encord>=0.1.200; extra == 'encord'
 Description-Content-Type: text/markdown
 
 <p align="center">
-  <img src="docs/assets/logo.svg" width="96" alt="lcode logo">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/logo-dark.png">
+    <img src="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/logo.png" width="360" alt="lcode">
+  </picture>
 </p>
 
-<h1 align="center">lcode</h1>
-
 <p align="center">
   <b>A coding agent that runs entirely on your own machine.</b><br>
   Open-weight models · up to 256K tokens of context · your NVIDIA GPU or Apple Silicon Mac · your code stays local
@@ -49,7 +50,7 @@ Description-Content-Type: text/markdown
   <a href="https://github.com/nasser1941/lcode/actions/workflows/ci.yml"><img src="https://github.com/nasser1941/lcode/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://nasser1941.github.io/lcode/"><img src="https://github.com/nasser1941/lcode/actions/workflows/docs.yml/badge.svg" alt="Docs"></a>
   <a href="https://pypi.org/project/lcode-cli/"><img src="https://img.shields.io/pypi/v/lcode-cli.svg" alt="PyPI"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <a href="https://github.com/nasser1941/lcode/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
   <img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python 3.10+">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20(Apple%20Silicon)-lightgrey.svg" alt="Linux and macOS">
 </p>
@@ -58,11 +59,11 @@ Description-Content-Type: text/markdown
   <a href="https://nasser1941.github.io/lcode/"><b>Documentation</b></a> ·
   <a href="https://nasser1941.github.io/lcode/installation/">Install</a> ·
   <a href="https://nasser1941.github.io/lcode/models/">Models</a> ·
-  <a href="CONTRIBUTING.md">Contributing</a>
+  <a href="https://github.com/nasser1941/lcode/blob/main/CONTRIBUTING.md">Contributing</a>
 </p>
 
 <p align="center">
-  <img src="docs/assets/demo.svg" alt="lcode finding and fixing a bug, then running the tests" width="820">
+  <img src="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/demo.svg" alt="lcode finding and fixing a bug, then running the tests" width="820">
 </p>
 
 Point lcode at a repository and talk to it in your terminal. It explores the code, answers
@@ -222,8 +223,8 @@ See the pinned [Roadmap issue](https://github.com/nasser1941/lcode/issues/10). N
 ## Contributing
 
 Contributions are welcome: bug reports, model test results, docs and code. See
-[CONTRIBUTING.md](CONTRIBUTING.md). Please follow the [code of conduct](CODE_OF_CONDUCT.md), and
-report security issues privately as described in [SECURITY.md](SECURITY.md).
+[CONTRIBUTING.md](https://github.com/nasser1941/lcode/blob/main/CONTRIBUTING.md). Please follow the [code of conduct](https://github.com/nasser1941/lcode/blob/main/CODE_OF_CONDUCT.md), and
+report security issues privately as described in [SECURITY.md](https://github.com/nasser1941/lcode/blob/main/SECURITY.md).
 
 ## Acknowledgements
 
@@ -234,4 +235,4 @@ the open-weight models from Qwen, Poolside, NVIDIA and OpenAI,
 
 ## License
 
-[MIT](LICENSE) © 2026 Naser Derakhshan
+[MIT](https://github.com/nasser1941/lcode/blob/main/LICENSE) © 2026 Naser Derakhshan

{lcode_cli-0.33.0 → lcode_cli-0.34.0}/README.md

@@ -1,9 +1,10 @@
 <p align="center">
-  <img src="docs/assets/logo.svg" width="96" alt="lcode logo">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/logo-dark.png">
+    <img src="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/logo.png" width="360" alt="lcode">
+  </picture>
 </p>
 
-<h1 align="center">lcode</h1>
-
 <p align="center">
   <b>A coding agent that runs entirely on your own machine.</b><br>
   Open-weight models · up to 256K tokens of context · your NVIDIA GPU or Apple Silicon Mac · your code stays local
@@ -13,7 +14,7 @@
   <a href="https://github.com/nasser1941/lcode/actions/workflows/ci.yml"><img src="https://github.com/nasser1941/lcode/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://nasser1941.github.io/lcode/"><img src="https://github.com/nasser1941/lcode/actions/workflows/docs.yml/badge.svg" alt="Docs"></a>
   <a href="https://pypi.org/project/lcode-cli/"><img src="https://img.shields.io/pypi/v/lcode-cli.svg" alt="PyPI"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <a href="https://github.com/nasser1941/lcode/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
   <img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python 3.10+">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20(Apple%20Silicon)-lightgrey.svg" alt="Linux and macOS">
 </p>
@@ -22,11 +23,11 @@
   <a href="https://nasser1941.github.io/lcode/"><b>Documentation</b></a> ·
   <a href="https://nasser1941.github.io/lcode/installation/">Install</a> ·
   <a href="https://nasser1941.github.io/lcode/models/">Models</a> ·
-  <a href="CONTRIBUTING.md">Contributing</a>
+  <a href="https://github.com/nasser1941/lcode/blob/main/CONTRIBUTING.md">Contributing</a>
 </p>
 
 <p align="center">
-  <img src="docs/assets/demo.svg" alt="lcode finding and fixing a bug, then running the tests" width="820">
+  <img src="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/demo.svg" alt="lcode finding and fixing a bug, then running the tests" width="820">
 </p>
 
 Point lcode at a repository and talk to it in your terminal. It explores the code, answers
@@ -186,8 +187,8 @@ See the pinned [Roadmap issue](https://github.com/nasser1941/lcode/issues/10). N
 ## Contributing
 
 Contributions are welcome: bug reports, model test results, docs and code. See
-[CONTRIBUTING.md](CONTRIBUTING.md). Please follow the [code of conduct](CODE_OF_CONDUCT.md), and
-report security issues privately as described in [SECURITY.md](SECURITY.md).
+[CONTRIBUTING.md](https://github.com/nasser1941/lcode/blob/main/CONTRIBUTING.md). Please follow the [code of conduct](https://github.com/nasser1941/lcode/blob/main/CODE_OF_CONDUCT.md), and
+report security issues privately as described in [SECURITY.md](https://github.com/nasser1941/lcode/blob/main/SECURITY.md).
 
 ## Acknowledgements
 
@@ -198,4 +199,4 @@ the open-weight models from Qwen, Poolside, NVIDIA and OpenAI,
 
 ## License
 
-[MIT](LICENSE) © 2026 Naser Derakhshan
+[MIT](https://github.com/nasser1941/lcode/blob/main/LICENSE) © 2026 Naser Derakhshan

lcode_cli-0.34.0/docs/assets/extra.css

@@ -0,0 +1,60 @@
+.hero {
+  text-align: center;
+  padding: 1.5rem 0 0.5rem;
+}
+
+.hero h1 {
+  font-size: 3rem;
+  font-weight: 800;
+  margin: 0.5rem 0 0.25rem;
+  letter-spacing: -0.02em;
+}
+
+.hero-logo {
+  width: 360px;
+  max-width: 80%;
+  height: auto;
+  margin: 0.5rem 0 0.75rem;
+}
+
+.hero p {
+  font-size: 1.1rem;
+  max-width: 44rem;
+  margin: 0.5rem auto 1.25rem;
+}
+
+.demo {
+  display: block;
+  margin: 1.5rem auto;
+  border-radius: 10px;
+  box-shadow: 0 12px 40px rgba(0, 0, 0, 0.25);
+}
+
+/* In the page for screen readers and search, but the logo shows the name. */
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+}
+
+/* The buttons in the logo's colours. */
+.hero .md-button {
+  border-color: #00b8cc;
+  color: inherit;
+}
+
+.hero .md-button--primary {
+  background-color: #00e3fc;
+  border-color: #00e3fc;
+  color: #0a0e10;
+}
+
+.hero .md-button:hover,
+.hero .md-button:focus {
+  background-color: #00b8cc;
+  border-color: #00b8cc;
+  color: #0a0e10;
+}

{lcode_cli-0.33.0 → lcode_cli-0.34.0}/docs/index.md

@@ -7,9 +7,10 @@ hide:
 
 <div class="hero" markdown>
 
-![lcode logo](assets/logo.svg){ .hero-logo }
+![lcode](assets/logo.png#only-light){ .hero-logo }
+![lcode](assets/logo-dark.png#only-dark){ .hero-logo }
 
-# lcode
+# lcode { .sr-only }
 
 **A coding agent that runs entirely on your own machine.**
 Open-weight models · up to 256K tokens of context · your NVIDIA GPU or Apple Silicon Mac · your code stays local.

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

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

{lcode_cli-0.33.0 → 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.0 → lcode_cli-0.34.0}/mkdocs.yml

@@ -9,8 +9,8 @@ copyright: Copyright &copy; 2026 Naser Derakhshan · <a href="https://github.com
 theme:
   name: material
   custom_dir: overrides
-  logo: assets/logo.svg
-  favicon: assets/logo.svg
+  logo: assets/icon.png
+  favicon: assets/favicon.png
   icon:
     repo: fontawesome/brands/github
   font:

{lcode_cli-0.33.0 → lcode_cli-0.34.0}/pyproject.toml

@@ -61,6 +61,9 @@ path = "src/lcode/__init__.py"
 [tool.hatch.build.targets.wheel]
 packages = ["src/lcode"]
 
+[tool.hatch.build.targets.sdist]
+exclude = ["docs/assets/*.png"]  # images for the README and the docs site: not needed to build or install
+
 [tool.ruff]
 line-length = 120
 target-version = "py310"

lcode_cli-0.34.0/scripts/make_logos.py

@@ -0,0 +1,62 @@
+"""Make the logo files the README, the docs and PyPI use, from docs/assets/logo-original.png.
+
+    uv run --with pillow python scripts/make_logos.py
+
+- logo.png: the mark and the name, for light backgrounds
+- logo-dark.png: the same with a light name, for dark backgrounds (GitHub's dark mode, the docs' dark scheme)
+- icon.png: the mark alone, square (the docs' header)
+- favicon.png: the mark, small (browser tabs)
+"""
+
+from pathlib import Path
+
+from PIL import Image
+
+ASSETS = Path(__file__).resolve().parent.parent / "docs" / "assets"
+WIDTH = 1200  # sharp at the README's 360 pixels on a 3x screen
+LIGHT_TEXT = (230, 237, 243)  # GitHub's dark-mode text colour
+PAD = 0.03  # around the logo, as a share of its width
+
+
+def is_mark(r: int, g: int, b: int) -> bool:
+    return b > 120 and g > 100 and r < 120  # the cyan of the mark (anti-aliased edges included)
+
+
+def main() -> None:
+    original = Image.open(ASSETS / "logo-original.png").convert("RGBA")
+    box = original.getchannel("A").point(lambda a: 255 if a > 8 else 0).getbbox()
+    logo = original.crop(box)
+    pad = int(logo.width * PAD)
+    framed = Image.new("RGBA", (logo.width + 2 * pad, logo.height + 2 * pad))
+    framed.paste(logo, (pad, pad))
+    height = round(framed.height * WIDTH / framed.width)
+    light = framed.resize((WIDTH, height), Image.LANCZOS)
+    light.save(ASSETS / "logo.png", optimize=True)
+
+    dark = light.copy()
+    pixels = dark.load()
+    for y in range(dark.height):
+        for x in range(dark.width):
+            r, g, b, a = pixels[x, y]
+            if a and not is_mark(r, g, b):
+                pixels[x, y] = (*LIGHT_TEXT, a)
+    dark.save(ASSETS / "logo-dark.png", optimize=True)
+
+    # The mark: the cyan part on the left.
+    cyan = Image.new("L", logo.size)
+    lp, cp = logo.load(), cyan.load()
+    for y in range(logo.height):
+        for x in range(logo.width):
+            r, g, b, a = lp[x, y]
+            if a > 8 and is_mark(r, g, b):
+                cp[x, y] = 255
+    mark = logo.crop(cyan.getbbox())
+    side = round(max(mark.size) * 1.12)
+    square = Image.new("RGBA", (side, side))
+    square.paste(mark, ((side - mark.width) // 2, (side - mark.height) // 2))
+    square.resize((512, 512), Image.LANCZOS).save(ASSETS / "icon.png", optimize=True)
+    square.resize((96, 96), Image.LANCZOS).save(ASSETS / "favicon.png", optimize=True)
+
+
+if __name__ == "__main__":
+    main()

{lcode_cli-0.33.0 → lcode_cli-0.34.0}/scripts/social-preview.html

@@ -8,14 +8,14 @@
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;800&family=JetBrains+Mono:wght@400;700&display=block" rel="stylesheet">
 <style>
-  :root { --cyan: #22d3ee; --violet: #a78bfa; --text: #e2e8f0; --muted: #94a3b8; }
+  :root { --cyan: #00e3fc; --cyan-light: #8ef4ff; --text: #e6edf3; --muted: #94a3b8; }
   * { box-sizing: border-box; margin: 0; padding: 0; }
   html, body { width: 1280px; height: 640px; overflow: hidden; }
   body {
     font-family: Inter, system-ui, sans-serif; color: var(--text);
     background:
-      radial-gradient(900px 500px at 85% 20%, rgba(167, 139, 250, 0.22), transparent 60%),
-      radial-gradient(700px 500px at 10% 90%, rgba(34, 211, 238, 0.18), transparent 60%),
+      radial-gradient(900px 500px at 85% 20%, rgba(0, 227, 252, 0.14), transparent 60%),
+      radial-gradient(700px 500px at 10% 90%, rgba(0, 227, 252, 0.16), transparent 60%),
       linear-gradient(135deg, #0b1120 0%, #0f172a 55%, #111827 100%);
     display: flex; align-items: center; padding: 64px 72px; gap: 56px;
   }
@@ -25,12 +25,11 @@
     background-size: 40px 40px;
   }
   .left { flex: 1 1 0; position: relative; }
-  .brand { display: flex; align-items: center; gap: 22px; margin-bottom: 26px; }
-  .brand svg { width: 92px; height: 92px; filter: drop-shadow(0 10px 30px rgba(34, 211, 238, 0.25)); }
-  h1 { font-size: 104px; font-weight: 800; letter-spacing: -0.04em; line-height: 1; }
+  .brand { margin: 0 0 30px -10px; }
+  .brand img { height: 118px; display: block; filter: drop-shadow(0 10px 30px rgba(0, 227, 252, 0.22)); }
   .tagline { font-size: 34px; font-weight: 600; line-height: 1.25; margin-bottom: 30px; max-width: 560px; }
   .tagline span {
-    background: linear-gradient(90deg, var(--cyan), var(--violet)); -webkit-background-clip: text; color: transparent;
+    background: linear-gradient(90deg, var(--cyan), var(--cyan-light)); -webkit-background-clip: text; color: transparent;
   }
   .chips { display: flex; flex-wrap: wrap; gap: 12px; margin-bottom: 34px; max-width: 580px; }
   .chip {
@@ -56,18 +55,7 @@
 </head>
 <body>
   <div class="left">
-    <div class="brand">
-      <svg viewBox="0 0 128 128" aria-hidden="true">
-        <defs>
-          <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#1e293b"/><stop offset="1" stop-color="#0f172a"/></linearGradient>
-          <linearGradient id="fg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#22d3ee"/><stop offset="1" stop-color="#a78bfa"/></linearGradient>
-        </defs>
-        <rect width="128" height="128" rx="28" fill="url(#bg)" stroke="rgba(148,163,184,.35)" stroke-width="2"/>
-        <path d="M34 40 L62 64 L34 88" fill="none" stroke="url(#fg)" stroke-width="12" stroke-linecap="round" stroke-linejoin="round"/>
-        <rect x="70" y="80" width="30" height="10" rx="5" fill="url(#fg)"/>
-      </svg>
-      <h1>lcode</h1>
-    </div>
+    <div class="brand"><img src="../docs/assets/logo-dark.png" alt="lcode"></div>
     <p class="tagline">A coding agent that runs <span>entirely on your own machine.</span></p>
     <div class="chips">
       <div class="chip">Open-weight models</div>

{lcode_cli-0.33.0 → 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.0"
+__version__ = "0.34.0"
 
 API = ("Session", "Result", "Options", "SetupError")
 

{lcode_cli-0.33.0 → 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):