Skip to content

PocketContext 0.17.0

Choose a tag to compare

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

PocketContext 0.17.0

Run an initialized project's headless server and private tunnel together as one
foreground process:

./pocketcontext serve --headless --tunnel
  • One operating-system service can supervise both components. The command owns
    both and refuses an already running server or tunnel.
  • The tunnel starts after private-socket readiness, without opening reader TCP.
    Existing identity and address are preserved.
  • Ctrl+C, SIGTERM and authenticated stop stop both and flush the database.
    Startup and terminal component errors shut down the other component and return
    an error so the service manager can restart the process.
  • tunnel serve remains available with its independent background-server
    behavior; stopping that tunnel still leaves its server running.
  • --tunnel requires --headless. Configure an OS service explicitly for boot,
    login and crash recovery; the CLI does not install one.

See Running a permanent service for a systemd user unit and
migration from two separate units. Follow Upgrades and use
matching client/server releases; regenerate installed skills after upgrading.

No database format, authentication protocol or dependency changes. Existing
single-user databases from 0.11.x through 0.16.2 require no data conversion.


PocketContext 0.17.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.17.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.17.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.