Skip to content
This repository was archived by the owner on Nov 8, 2026. It is now read-only.

PocketContext 0.19.0

Choose a tag to compare

@github-actions github-actions released this 03 Nov 11:09
Immutable release. Only release title and notes can be modified.

0.19.0 — Agent chat in the reader

Optional built-in chat connects the PocketContext reader to a host-side Codex ACP
adapter. A phone can ask questions and review agent permission requests through the
same signed-in reader. PocketContext still ships its server, reader, CLI, HTTPS and
ACP bridge in one binary; chat additionally needs a separately installed adapter,
Node.js and provider sign-in on the host. No agent runtime is installed on the phone.

  • Enable chat explicitly with serve --chat-agent ABS_EXECUTABLE and optional
    --chat-args JSON_ARRAY. It composes with --headless, --domain and --tunnel.
    Browser requests cannot select an executable.
  • The first supported adapter is @agentclientprotocol/codex-acp@2.5.0 with
    @openai/codex@0.165.0. Sessions use read-only mode and on-request approvals.
    Permission controls preserve the adapter's actual choices.
  • Host sessions survive browser disconnection. Private local transcripts survive
    server restarts; agent restoration depends on ACP session/load support and
    successful restoration. Interrupted work is explicit and prompts are not replayed.
  • Knowledge operations use the authenticated CLI/API under generated instructions;
    a scratch directory and instructions do not constitute a security sandbox.
  • Chat is disabled unless configured. Existing local reader, native HTTPS,
    private tunnel and external-agent workflows remain available.

Read chat setup and limitations. Provider authentication is configured
on the host, separately from reader sign-in. External AI services receive the
context the agent sends and their costs and limits apply.

There is no knowledge schema migration. Projects from 0.11.x–0.18.0 keep database
format 1; 0.10.0 and earlier remain unsupported. Follow the upgrade procedure:
verify the release, cleanly stop the project, back up the complete project and
matching old binary, explicitly replace it, then refresh profiles/skills and clients.
Chat transcripts and provider credentials are private machine state, outside the
synced project backup.


PocketContext 0.19.0: a local knowledge base: server, reader and CLI in one binary.

Linux amd64 and arm64: static musl binaries. macOS arm64: macOS 15 or later, ad hoc signed. Windows amd64: statically linked MinGW build, unsigned.

Install on Linux or macOS into the project folder: curl -fsSL https://github.com/pocketcontext-labs/pocketcontext/releases/download/v0.19.0/install.sh | sh -s -- /absolute/project/folder

Install on Windows (PowerShell): $env:POCKETCONTEXT_INSTALL_DIR = 'C:\absolute\project\folder'; irm https://github.com/pocketcontext-labs/pocketcontext/releases/download/v0.19.0/install.ps1 | iex

Both installers require the target folder, usually the project folder beside pocketcontext.db (it may be inside iCloud Drive, OneDrive, Dropbox or Google Drive).

See the README.