context-use

A self-hosted brain for you. A public billboard for everyone else.

Context Use is a self-hosted knowledge base that your AI agents read and write over MCP. It accumulates what you're working on, who you work with, and how you like things done, and it can publish a public version of any part of it.

It writes itself

Two things feed it. Your agents write to it directly — decisions, preferences, context from whatever you're doing with them. Data connections write to it indirectly: meetings, pull requests, and more as integrations are added. You don't maintain it by hand.

Related MCP server: llmwiki-serve

Everything is linked

Context Use extracts the people, companies, events, meetings, trips, and tasks out of that activity and links them to each other. A person's page connects to the meeting where you met them, the company they work at, and the project you started together. You navigate by following those links, and so do your agents.

Agents keep it organized

Versioned instruction pages tell agents how to summarize, connect, and maintain durable knowledge. Agents find those pages through object search and stable links, just like every other page in the knowledge graph. That's what keeps a knowledge base this size usable rather than a pile of notes.

Private by default

It runs on your machine or in your AWS account, and agents reach it over OAuth-protected MCP. Nothing goes through a third party.

You can publish selected pages — an introduction, your projects, your ideas — as a public profile. Agents can draft those pages but cannot publish them. That decision is always yours.

Self-host on AWS

You need an authenticated AWS CLI profile, Terraform 1.11+, GitHub CLI, and a hostname you control.

curl --proto '=https' --tlsv1.2 -fsSL https://github.com/massimoalbarello/context-use/releases/latest/download/install.sh | sh

~/.local/bin/context-use setup

Follow the prompts for your AWS profile, region, hostname, DNS, and owner email. The CLI deploys the application, configures TLS, and gives you a one-time owner setup link. Manage the installation later with context-use status, context-use update, and context-use doctor.

Choose a different supported x86-64 instance type during setup, or resize an existing deployment:

~/.local/bin/context-use setup --instance-type t3a.medium
~/.local/bin/context-use resize --instance-type t3a.medium

Resizing can recreate the disposable EC2 instance and root disk, causing several minutes of downtime, but it retains and reattaches the encrypted data volume before redeploying the runtime. Context Use requires at least 2 vCPU and 4 GiB RAM.

To run it on your own machine instead, see Development.

Connect an agent

Point any MCP-capable agent at:

https://YOUR_HOST/mcp

OpenClaw active memory

From this checkout, mount or remount automatic recall and capture with one command:

bun run openclaw:mount

Use bun run openclaw:off to unmount it without uninstalling, the mount command to remount it, and bun run openclaw:remove to restore the previous memory setup and uninstall the plugin. See the OpenClaw plugin guide.

Ingest your data

AWS installations run Nango to sync data from providers such as GitHub and Granola into your knowledge base. See docs/nango.md.

Documentation

• Development — running locally, tests, and bootstrap maintenance.

• Data ingestion — Nango setup, integrations, and operations.

• Security

License

MIT