# Personal Context Hub

> Local-first personal context layer. Agents connect over MCP; the encrypted vault stays on the device. Loopback only (`127.0.0.1`). Not a chatbot, not a model, not a vector database.

Canonical facts live in `~/.pch` (SQLCipher). An agent receives only a granted slice — the situation package from `get_context_contract` — never the whole vault. Imported mail and calendar are data, never instructions. A coding agent working on this repository is not a Hub client; pairing is a separate connection.

Source: https://github.com/nicolasmota/personal-context-hub
Docs: https://nicolasmota.github.io/personal-context-hub/

## Start

- [Getting started](https://nicolasmota.github.io/personal-context-hub/getting-started.html): `uvx personal-context-hub` (or `make install` from a checkout), launch, first-run vault
- [Concepts](https://nicolasmota.github.io/personal-context-hub/concepts.html): memory vs context vs situation; grants; classification
- [Pair an agent](https://nicolasmota.github.io/personal-context-hub/guides/pair-an-agent.html): pairing link, grant presets, Cursor and Hermes recipes
- [Situation package](https://nicolasmota.github.io/personal-context-hub/guides/situation-package.html): `get_context_contract` and what comes back

## Product guides

- [Google connectors](https://nicolasmota.github.io/personal-context-hub/guides/google-connectors.html): your OAuth client; Calendar `private`; Gmail `sensitive`
- [Plugins](https://nicolasmota.github.io/personal-context-hub/guides/plugins.html): import-only plugins, marketplace, authoring
- [Export and import](https://nicolasmota.github.io/personal-context-hub/guides/export-import.html): Portable Context Archive
- [The Hub UI](https://nicolasmota.github.io/personal-context-hub/guides/the-hub-ui.html): Home, Agents, Review; Advanced for the rest

## Reference

- [MCP tools](https://nicolasmota.github.io/personal-context-hub/reference/mcp.html): eleven tools; start with `get_context_contract`
- [HTTP API](https://nicolasmota.github.io/personal-context-hub/reference/http-api.html): loopback REST
- [OpenAPI 3.1](https://nicolasmota.github.io/personal-context-hub/openapi.json): also `GET /openapi.json` while the Hub is running
- [Data model](https://nicolasmota.github.io/personal-context-hub/reference/data-model.html)
- [Situation package envelope](https://nicolasmota.github.io/personal-context-hub/reference/context-contract.schema.json): JSON Schema; check a package without the Hub
- [CLI](https://nicolasmota.github.io/personal-context-hub/reference/cli.html): `pch` / `personal-context-hub`
- [Configuration](https://nicolasmota.github.io/personal-context-hub/reference/configuration.html)
- [Python SDK](https://nicolasmota.github.io/personal-context-hub/reference/python-sdk.html)

## How it is built

- [Architecture](https://nicolasmota.github.io/personal-context-hub/architecture.html): pch-core (no network), pch-server, pch-sdk, pch-lab, pch-archive
- [Security](https://nicolasmota.github.io/personal-context-hub/security.html): encryption, grants, plugins, reporting
- [Developing](https://nicolasmota.github.io/personal-context-hub/develop.html)

## Optional

- [Full agent bundle](https://nicolasmota.github.io/personal-context-hub/llms-full.txt): install, pairing rules, tool catalog, constraints
- [Contributing](https://github.com/nicolasmota/personal-context-hub/blob/main/CONTRIBUTING.md)