Skip to content

Changelog

Notable changes per release. Versions follow SemVer; the git tag is the single source of truth — the PyPI wheel, the Docker image tag and the app's own __version__ all derive from it. Release artifacts: PyPI, Docker Hub, GitHub Releases.

1.2.1 — 2026-10-18

Added

  • Settings → Providers has a new Environment section in each provider's panel. Use it to set extra environment variables for everything that provider's CLI runs: chat, auto-journal and the context probe. Each variable has its own enable toggle. New sessions use a change right away, and open sessions pick it up on their next message, with no server restart. Claude offers CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT=1 as a suggested row, disabled until you tick it. Variables the app manages itself, such as the account token and PAINAPPLE_*, can't be overridden. Once any value is stored, the server config file becomes readable only by its owner.

Changed

  • When you hover a web link in chat or in a Markdown preview, the tooltip now shows the full URL.

Fixed

  • In YOLO mode, Claude Code CLI safety checks that need explicit approval (for example, 2.1.299+'s prompt for bash -c scripts that run rm) now show an approve/deny card. Before, they failed as "blocked by YOLO permission mode".

1.2.0 — 2026-10-14

Added

  • When an enabled agent CLI is older than the version pAInapple Code needs, a popup now says so on load. It shows the installed and minimum versions and what breaks below the minimum, and has an Update in terminal button that runs claude update in a terminal tab and confirms when it's done. You can choose Later or Don't show again for this version. The same warning appears in the server log at startup and under the version line in Settings → Providers. It's also available as the "CLI Version Check" quick action.

Changed

  • Requires Claude Code CLI 2.1.293 or newer for the default auto-journal model. Older CLIs reject Haiku 5.5, and journal summaries fail until you update.
  • The auto-journal now uses Haiku 5.5 by default, replacing Haiku 4.5.
  • The model picker adds Haiku 5.5 and drops Opus 5 (Opus 5.5 remains). Sessions that had Opus 5 selected fall back to the default model.

1.1.11 — 2026-10-14

Fixed

  • The quick switcher's file search (Cmd/Ctrl+K) no longer loses the project's own files when an extra directory is attached. A large extra directory used to fill the whole 20,000-file list, so the project's files vanished from search, for example every .php file in a PHP project. Project files now always come first, and hits from extra directories rank below in-project ones.
  • Files from extra directories show their absolute path with the leading / (/data/...) instead of data/..., which looked like a folder inside the project.

1.1.10 — 2026-10-12

Added

  • Codex sessions support /goal. /goal <objective> sets a goal, and Codex then starts turns on its own until it marks the goal complete. /goal pause, resume and clear control it, and a bare /goal shows the current one. A goal bar above the input shows the objective, its status and the tokens and time it has used, with Pause/Resume and Clear buttons. The chat records each change, for example "Goal set", "Goal paused" and "Goal complete — 18.3k tokens · 8s". Pressing Stop pauses an active goal. Codex's own commands (/goal, /compact) now appear in the / popup.

Fixed

  • Codex no longer leaves an empty message bubble at the end of some turns.

1.1.9 — 2026-10-12

Added

  • Mermaid diagrams render in chat and in the markdown preview: a ```mermaid block (or an untagged block that starts with a diagram header like flowchart TD, the way Codex writes them) shows as a diagram, with a button to flip back to the source. If the diagram doesn't parse, the code stays visible with the error underneath.
  • A second journal helper agent, shadow-db-helper, that searches the turn database (prompts, summaries, decisions, costs, files touched). It sits next to shadow-git-helper, which handles file history.
  • Both helper agents are now installed for every enabled provider that is available on the server, in that provider's own format. Codex sessions can now ask for them by name. Before, only Claude got them.

Fixed

  • shadow-git and shadow-query now use the server that started the session. Before, they always read ~/.painapple-code and http://localhost:8765, so under a host profile, another port, TLS or Docker they showed a frozen copy of the journal or queried the wrong server. That looked like "turns aren't being committed". Outside a session, shadow-git picks the most recently written journal across the root home and its profiles, and says which one it used.
  • shadow-git works on macOS systems that have no sha256sum.
  • Files that Codex creates or edits now show their content and diffs in chat, the same way Claude's edits do. Before, a Codex file change showed only the path.

1.1.8 — 2026-10-07

Fixed

  • A markdown image that points at a local file (![screenshot](/path/to/shot.png), or a path relative to the session folder) now shows as a thumbnail instead of a broken-image box. Clicking it opens the image viewer, with the chat's other images one swipe away. If the file is missing, the alt text shows as a plain file link. Images from the web are unchanged.

1.1.7 — 2026-10-07

Changed

  • Uploads are now stored per project (projects/{hash}/uploads/) instead of per session, so one folder holds everything ever uploaded to a project. The Uploads widget shows that folder (click to copy its path), and "Only this session" still filters by the session that uploaded each file. Files from existing sessions are linked into the project folder automatically; nothing is moved or deleted. Uploading a file whose name is already taken saves it as name-2.ext instead of overwriting the earlier one.
  • The upload size limit is now 128 MB for both files and images (it was 10 MB for files and 20 MB for images). Change it under Settings → System → Max Upload Size.

Fixed

  • An upload that is too large or that fails now shows an error toast. Before, its chip just disappeared and the reason only reached the debug log. Oversized files are refused before they are sent, and errors from a reverse proxy (an HTML 413 or 502 page) read as a plain message instead of "Unexpected token <".
  • Sending a message with an image attached in a Codex session failed every time with an internal error (UnboundLocalError). It works again, and start/send failure messages now name the session's provider instead of always saying "Claude".
  • An image attached to a prompt is no longer stored twice.
  • The Uploads widget no longer returns 404 when opened on a tab that hasn't connected yet.

1.1.6 — 2026-10-02

Fixed

  • A message sent while a Codex /compact is running now waits and runs once the compaction finishes (as it does on Claude), instead of failing with "ActiveTurnNotSteerable … Failed to send message". Pressing Stop discards the waiting message.
  • Default permission modes are now kept per provider: choosing Set as default on a Codex tab (e.g. Full access) saves it as Codex's default and new Codex sessions open with it, instead of always falling back to Workspace write. Claude keeps its own default. Each provider's default is also editable under Settings → Providers → New Session Defaults; an existing app-wide default carries over to the providers that support it.

1.1.5 — 2026-10-01

Fixed

  • /compact in a Codex session now actually compacts the conversation (with the usual "Conversation compacted" marker) instead of being sent to the model as a prompt. Codex's own automatic compactions now show up in the chat too.

1.1.4 — 2026-10-01

Fixed

  • Codex sessions get rich turn summaries and auto-generated session titles again on newer Codex CLIs (0.159+); the summary fork was being rejected, leaving only the raw journal. Summary-fork failures are now logged as warnings instead of disappearing.
  • Markdown links to local files in chat — [name](/abs/path/file.md), ./x.md, file://…, optionally with #L12 / :12 line targets — open the file preview instead of navigating the browser to a dead server URL.

1.1.3 — 2026-10-01

Fixed

  • Codex sessions now ask for MCP tool approvals with the same in-chat permission card Claude sessions use — Allow / Deny, plus "always allow" for this session or for good. Previously Codex rejected every MCP tool call that needed approval (anything not marked read-only).
  • Switching a Codex session's permission mode (e.g. to Full access, the equivalent of codex --yolo) now takes effect for the existing conversation; before, a resumed Codex thread kept the sandbox it was started with, even across server restarts.
  • Failed ! bang commands show the stderr explaining the failure instead of a bare "Exit code: N", and output written to both stdout and stderr is no longer cut down to stdout.

1.1.2 — 2026-09-30

Added

  • pbcopy in the built-in terminal on Linux and macOS servers: git diff | pbcopy copies to the clipboard of the device you're using (via OSC 52, so it needs Settings → Terminal → "Terminal apps may write to clipboard"; inside tmux also set -g allow-passthrough on). A server's native pbcopy still takes priority.

Changed

  • Claude Sonnet 5.5 replaces Sonnet 5 in the model catalog, and is the new default model for the shadow-git-helper subagent.

1.1.1 — 2026-09-23

Added

  • Claude Opus 5.5 (1M context) in the model catalog, replacing Opus 4.8.

Fixed

  • Fresh installs show the real app icon — in the browser tab, on the login page and as the installed PWA/home-screen icon — instead of a generic "P" tile, and the service worker no longer fails to install from the login page.
  • painapple setup no longer forces a container-runtime choice: a Skip option (the default when nothing is configured yet) leaves the runtime and image untouched, and an existing custom runtime path is kept on Enter.

1.1.0 — 2026-09-08

Also ships everything listed under 1.0.5 below — that tag was cut but never published.

Added

  • Long option descriptions in AskUserQuestion cards no longer get silently clipped: a clamped description gets a Show more / Show less toggle, and the option you chose is shown in full on the answered card.

1.0.5 — 2026-09-05 (tagged, never published)

CI failed on the tag — a test pinned a model id the catalog change below had just removed — so no PyPI, Docker Hub or GitHub Release artifacts exist for 1.0.5. The tag stays; its changes ship in the next release.

Added

  • Turns now credit files that Claude edits or reads through Bash (sed -i, heredocs, tee, mv, …), not only through the Edit/Write/Read tools: the file pills, the Shadow DB turn_files table, recent-files ranking and the per-session /changes rescan all see them. The staged diff at commit time is used as a final catch-all for anything else that touched the tree (generators, npm install).

Changed

  • Model catalog: Fable 5 replaced by Fable 5.1.

Fixed

  • The self-signed TLS certificate now lists the actual bind address in its SAN, so browsers connecting by IP stop rejecting it.

1.0.4 — 2026-08-31

Added

  • Every container start logs the image version it is running (org.opencontainers.image.version), so a stuck :latest is never silent.
  • "Port already in use" now offers a concrete free --port and a ready-made named profile; painapple setup no longer defaults to a port that is taken.

Fixed

  • --project / --no-project now also steer the mount mode picked by --in-docker.
  • Raw docker run examples in the docs use the right scheme and pass --tls off explicitly; Podman example adds the missing mkdir.

1.0.3 — 2026-08-31

Added

  • --project / --no-project workspace mode with .git auto-detect: serve one repository as a single pickable project rather than as the workspace root.

Fixed

  • A wrong bind host is reported as such instead of masquerading as "port already in use".
  • The annotate button in the image pan-zoom toolbar was rendered at the wrong size.

1.0.2 — 2026-08-31

Changed

  • "Engines" are now called Providers everywhere: Settings tab, status-bar chip, session setup panel, and the HTTP API — /api/engines* moved to /api/providers* and the engine fields/query parameters are now provider. Saved sessions and configs keep working.
  • Slash-command autocomplete descriptions clamp to two lines and expand on hover/selection; the full text is available in the tooltip.

Fixed

  • Autocomplete descriptions no longer paint over the command name on long entries.
  • Descriptions of skills embedded in the Claude CLI are extracted correctly when the name and description keys are not adjacent.
  • A stale fetchAgentCommands call on the connected frame was removed.

1.0.1 — 2026-08-31

Removed

  • The two "plain CLI" fallback drivers: the claude line-protocol driver (superseded by the wire-identical claude-sdk provider) and the codex exec driver (codex exec --json had no stdin protocol — every prompt rode argv, readable via ps by any local account; see SECURITY.md). Saved configs keep working: the legacy provider names alias to claude-sdk and codex-app-server, and old Codex exec sessions resume natively through the same $CODEX_HOME thread store.

Fixed

  • Docs: TLS opt-in now points at the [tls] extra instead of a hardcoded dependency pin.

1.0.0 — 2026-08-26

First public release.