Repository navigation
PocketContext 0.19.0
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_EXECUTABLEand optional
--chat-args JSON_ARRAY. It composes with--headless,--domainand--tunnel.
Browser requests cannot select an executable. - The first supported adapter is
@agentclientprotocol/codex-acp@2.5.0with
@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 ACPsession/loadsupport 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.