Repository navigation
PocketContext 0.17.0
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
stopstop 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 serveremains available with its independent background-server
behavior; stopping that tunnel still leaves its server running.--tunnelrequires--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.