@promptowl/contextnest-community
v4.0.0
Published
ContextNest Community Edition — self-hosted context governance server for AI workflows. Commercial software by Promptowl LLC.
Downloads
2,910
Readme
ContextNest Community Edition
Self-hosted context governance server for AI workflows. Part of the PromptOwl platform.
⚠️ Commercial Software. ContextNest Community Edition is proprietary software licensed by Promptowl LLC. A free PromptOwl account is required to use it. Redistribution, hosting-as-a-service, and competitive use are prohibited. See LICENSE.md for full terms.
What it is
A shared knowledge base for your team and your AI agents, running on your own machine or infrastructure. Documents live in nests; every save is a version; in a stewarded nest a change waits for a reviewer before agents can read it. People write in the browser, agents read and write the same documents over MCP, HTTP or the ctx CLI.
Concretely, it lets you:
- Write Markdown documents — plus hosted HTML artifacts and CSV tables agents can query row by row — filed in folders, linked with
[[Title]], tagged, commented on, and versioned - Import an existing folder of Markdown in one step; export a nest as a portable bundle
- Govern changes — draft → pending review → approved — with stewards per nest, tag or document, and a cross-nest inbox (My Work, My Drafts) for what is waiting on you, including board tasks assigned to you
- Share a nest with people or teams, share a single document or folder, or publish read-only to the public
- Give agents deterministic reads: the same selector returns the same context every time, with a trace of what was pulled
- Run agents against a nest (Workflows, Beta): an agent is a document whose body is instructions; its output lands as a pending review
- Sync with the PromptOwl hosted platform for accounts, licensing and teams
Your PromptOwl account handles authentication, entitlement, and governance metadata.
Quickstart
# 1. Run the community server
npx @promptowl/contextnest-community
# 2. Open the server in your browser
# http://localhost:3838
# On first boot with no license, it lands on the License Setup Page.
# 3. Paste your PromptOwl license key (pk_...) — see "License setup" belowThe server listens on http://localhost:3838 by default. Without a valid license the server still runs and serves reads, but write actions return 503 until you activate. See CONFIGURATION.md for all environment variables (port, auth mode, storage, telemetry).
Docker and Kubernetes
Each release also publishes a container image, ghcr.io/promptowl/contextnest-community:<version> (and :latest). It runs as a non-root user (uid 1000) and keeps everything under /data:
docker run -p 3838:3838 -v contextnest-data:/data ghcr.io/promptowl/contextnest-community:latestFor a single VM with HTTPS and PostgreSQL, use the Compose bundle in deploy/compose: set two values in .env, then docker compose up -d.
For Kubernetes, use the Helm chart in deploy/helm/contextnest-community: helm install cn deploy/helm/contextnest-community. See CONFIGURATION.md → Kubernetes (Helm).
License setup
ContextNest Community Edition requires a PromptOwl Community License key (pk_...). Getting and activating one:
1. Create the key (free)
- Sign up or log in at https://app.promptowl.ai
- Open the Overview menu → Community License
- Click Create a Community License key
- Copy the generated key — it starts with
pk_
2. Activate the server
Pick one of two ways:
A. Browser setup page (recommended for first run)
- Start the server:
npx @promptowl/contextnest-community - Open http://localhost:3838 — with no license installed, the server boots into setup mode and shows the License Setup Page
- Paste your
pk_...key and submit - The server validates it against PromptOwl, writes it to your
.env, and exits setup mode — no restart needed
B. Environment variable (recommended for Docker / CI / scripted deploys)
PROMPTOWL_KEY=pk_... npx @promptowl/contextnest-communityThe key is read at boot. The server validates against PromptOwl on startup; if valid, it goes straight into licensed mode.
3. How licensing behaves at runtime
- Unlicensed / Free tier — a server with 10 or fewer users accepts writes without a key, matching the published Free tier ("free for up to 10 users"). Users are counted as a Free key counts them (nest owners, admins, reviewers, server admins); viewers are free and never count. With more than 10 users and no valid key, reads still work but every write returns
503until a key is installed. - Live license checks — the server re-checks its key with PromptOwl every minute. If the key is rejected or suspended, the server goes read-only within minutes: reads keep working, nobody is signed out, and writing comes back on its own once the key is valid again.
- Plans, seats and models — the key's plan (Free, Self-Hosted, Enterprise) sets how many users, editors and server admins you can have, and how AI models are paid for. See LICENSING.md.
- Admin identity follows the license — the admin user is whichever PromptOwl account owns the installed key, resolved live per request. Transferring the license to another account immediately promotes the new owner and demotes the old one.
For redistribution, hosted-service, OEM, or regulated-industry licensing, contact [email protected].
First five minutes
- Create a nest. A new account with no nest opens on Getting started: one click makes your own nest, connects your agents and fills it (write, distill a public site or GitHub repo, or connect Slack). Otherwise use the Nests page, or Import folder to bring in Markdown you already have.
- Write a document.
[[Title]]links another document,@namementions a person, tags go under the title. Every save is a version. - Turn on stewardship (nest Settings) if you want review. Saves become drafts; Submit for review; a steward approves or rejects. Alone? Allow self-approve and you get the history without the ceremony.
- Connect an agent. Inside a nest, Connect (bottom of the sidebar) gives you the MCP URL and a REST snippet; Add with AI (nest overview) is a prompt that has an agent write context in. Mint a key under Workspace → API keys.
- Share. The whole nest with a person or team, one document or folder, or make it public with a read-only Reader mode. Share public link in a document's menu publishes and copies a link in one click.
The in-app How it works page (sidebar → Help) is the full tour; Docs (header) is the agent manual.
Around the app
| Where | What | Who |
|---|---|---|
| Header ribbon | My Work — the one queue for reviews, assigned tasks, handoffs, mentions and saved messages across nests, with a count that turns red when something is urgent · My Drafts (yours, never submitted). Inside a nest, Browse and Instructions sit beside them. | everyone |
| Left rail | Nests — every nest you can see on every page, with a filter box and the current nest unfolded · Stream (experimental, EXPERIMENTAL_DOC_STREAM) — a feed of every document version across your nests, people and agents · Control room (while Surfaces is on) — Overview, Decision ledger and Agents for the nests you administer; Slack setup for server admins | everyone / nest admins |
| Account menu → Workspace settings | Teams · API keys · Connected apps — and for server admins Teammates · Server settings · Activity trace · Message log | everyone / server admins |
| Account menu | Account (name, password) · How it works · keyboard shortcuts · logout | everyone |
Inside a nest: the document tree, plus Board (documents as cards by folder, status or tag), Graph (documents, links, tags, stewards), Definitions (the nest's glossary), Workflows (Beta) and, with team chat on (TEAM_CHAT_ENABLED), Channels — channels, private channels and direct messages for the nest's people and agents. Ctrl/⌘ K searches every nest and document; ? lists shortcuts.
Connect an agent
Point any agent at <server>/llms.txt — it is the complete manual (endpoints, MCP tools, selector grammar). The short version:
- Claude Code plugin —
/plugin marketplace add promptowl/contextnest,/plugin install contextnest, then/contextnest:setupwalks you through connecting (browser sign-in, no key to paste). - Terminal sign-in — install the CLI (
npm i -g @promptowl/contextnest-cli, Node 20+), thenctx login <server>(ctx 3.4+), e.g.ctx login https://nest.promptowl.ai. It opens your browser to approve and registers the server as one alias, named after the host (promptowlhere): every nest you can reach shows up inctx vault listas<alias>/<nest>. Signing in uploads nothing. A server without browser sign-in takes a key instead: add--key-stdinand paste a key from the Connect dialog. - MCP —
<server>/mcpfor everything the key can read,<server>/nests/<id>/mcpfor one nest with the full toolset. Claude Code, Cursor and VS Code connect over HTTP withAuthorization: Bearer cnst_…; Claude Desktop goes throughnpx -y mcp-remote. - REST —
POST /nests/<id>/contextwith a selector (#tag,[[Title]],type:document, combined with+ | -) returns assembled context plus a trace. Full reference: API.md. - ctx CLI —
ctx vault add <alias> --url <server>/nests/<id>/mcp --bearer-env CONTEXTNEST_API_KEY, thenctx query "#tag" --vault <alias>.
Keys are minted in the app (Workspace → API keys, or the Connect dialog) — one per client, user-wide or scoped to a nest. Servers in AUTH_MODE=open need none.
System requirements
- Node.js 20.x or later
- PromptOwl account — free signup at https://app.promptowl.ai/signup
- OS: Windows, macOS, or Linux
- Disk: ~200 MB for the server, plus storage for your nests
What you get
The Community Edition column is the Free and Self-Hosted plans. Enterprise features turn on by themselves when an Enterprise licence key is installed — nothing to enable. See LICENSING.md.
| Feature | Community Edition | Enterprise |
|---|:---:|:---:|
| Self-hosted context server | ✅ | ✅ |
| SQLite or PostgreSQL / Cloud SQL backend | ✅ | ✅ |
| Configurable nest storage (external / GCS volume mount) | ✅ | ✅ |
| Markdown + YAML frontmatter vaults | ✅ | ✅ |
| Import existing folder / vault | ✅ | ✅ |
| Export nest as portable bundle (.zip) | ✅ | ✅ |
| Markdown rendering + wiki cross-linking | ✅ | ✅ |
| External-edit detection + version diff | ✅ | ✅ |
| Stewardship workflow (draft/review/approve) | ✅ | ✅ |
| Per-nest sharing + collaborators | ✅ | ✅ |
| Public read-only nests | ✅ | ✅ |
| Custom logo / branding | ✅ | ✅ |
| Admin password reset + user removal (in-platform) | ✅ | ✅ |
| Wiki backlinks, outline, hover-preview, link health | ✅ | ✅ |
| Rich editor — tables, callouts, toggles, code highlight, find/replace, image & video upload, YouTube / Vimeo embeds | ✅ | ✅ |
| Folder organization — nested folders, move documents, lazy folder tree | ✅ | ✅ |
| Scales to large vaults — nest listings served from a document index, not a disk crawl | ✅ | ✅ |
| Steward version revert | ✅ | ✅ |
| MCP server for AI agents | ✅ | ✅ |
| One-shot agent setup — generated connect prompt + .env download | ✅ | ✅ |
| Several API keys per account — one credential per client, rotate one at a time | ✅ | ✅ |
| Comments on documents — anchored threads, resolve / reopen, same threads over MCP | ✅ | ✅ |
| Table nodes — CSV facts with deterministic row queries (POST /table-query, context_table_query) | ✅ | ✅ |
| Teams — share a nest with a group once; import rosters from PromptOwl | ✅ | ✅ |
| Cross-nest inbox — My Work (assigned tasks, reviews, handoffs) and My Drafts | ✅ | ✅ |
| Nest views — Board (kanban by folder / status / tag), Graph, Definitions glossary | ✅ | ✅ |
| Workflow plane (Beta) — agents as documents, runs, schedules, inbound hooks, Slack / Teams / webhook connectors | ✅ | ✅ |
| Activity trace — every governance action, per nest and server-wide | ✅ | ✅ |
| Document pins (experimental, superadmin switch EXPERIMENTAL_DOC_PINS) — stewards pin documents to the front of a nest for everyone; anyone pins for themselves | ✅ | ✅ |
| Team chat (TEAM_CHAT_ENABLED) — channels, private channels, direct and group messages, reactions, pins, saved messages, search, presence and live updates, for people and agents alike | ✅ | ✅ |
| Agents in the conversation — @hootie answers in a thread, agents are hired from a catalog, @mentions wake an agent's webhook, a thread becomes a decision or task node, Remember this turns chat into reviewed knowledge | ✅ | ✅ |
| Control room (with Surfaces on) — decision ledger of every agent decision, rollups, agent event API, guided Slack setup | ✅ | ✅ |
| Getting started — first-run onboarding: own nest, connect agents, distill a site or repo into drafts | ✅ | ✅ |
| One-click public link for a document, with link previews in Slack and chat | ✅ | ✅ |
| Review queue in My Work — Request changes vs Reject, bulk approve, a plain "What changed" summary | ✅ | ✅ |
| Archive documents — out of lists, search and AI retrieval, history kept, restore any time | ✅ | ✅ |
| Notifications — Slack, Microsoft Teams, email | ✅ | ✅ |
| Centralized multi-tenant admin console | — | ✅ |
| Sign-in with email, Google, or Sign in with PromptOwl — admin guide | ✅ | ✅ |
| Enterprise single sign-on (OIDC — Entra ID, Okta, Keycloak, any issuer) — licence feature sso | — | ✅ |
| Own model keys or LLM gateway (BYOK) — licence feature byok | — | ✅ |
| Custom assistant name and branding — licence feature hootie_branding | — | ✅ |
| SAML / SCIM provisioning | — | ✅ |
| Audit log streaming | — | ✅ |
| Policy transforms (redaction, summarization) | — | ✅ |
| Priority support and SLA | — | ✅ |
For Enterprise pricing and features, contact [email protected] or visit https://promptowl.ai/contextnest/.
What's new
4.0.0
- Team chat for people and agents. Channels, private channels and direct messages inside a nest, with reactions, edits, pins, saved messages, search and live updates. Agents post, reply and get @mentioned like people;
@hootieanswers in the thread; agents are hired from a catalog; Remember this turns a message into a reviewed node. Off by default:TEAM_CHAT_ENABLED=trueor Server settings. - Control room. A decision ledger of every agent decision, rollups, an agent event API and a guided Slack setup.
- Getting started. A new account opens on a welcome screen that makes a nest, connects agents and fills it.
- One review queue. My Work holds every review, with Request changes vs Reject, bulk approve and a "What changed" summary. My Work and My Drafts live in a header ribbon; workspace pages moved to Workspace settings in the account menu.
- Share public link and archive on every document.
Upgrade notes (breaking): on SHARED_DEPLOYMENT, "Share with a team…" replaces Organization visibility · channels are members-only to read · approving or rejecting an external edit needs approval authority (403 otherwise) · governance reads return only documents the caller can read · context_my_work returns notifications only when asked · /mentionable and collaborators people no longer list directory accounts.
Full release notes live in CHANGELOG.md.
Documentation
- CONFIGURATION.md — every environment variable (port, auth mode, storage, notifications, telemetry)
- Single sign-on admin guide — connect Microsoft Entra ID, Google, Okta, Keycloak or any OIDC provider; what happens to existing accounts, API keys and agents; every
sso_errorcode with its fix - API.md — complete REST reference with request and response bodies
- STEWARDSHIP.md — the governance model: modes, stewards, scopes, prime documents, teams, super-admins
- LICENSING.md — plans, seats, limits, model credits and BYOK, and how the license check behaves
<server>/llms.txt— the agent manual the running server publishes; rendered as Docs in the app- How it works inside the app — a page-by-page tour
Licensing
ContextNest Community Edition is commercial software. It is not open source.
You may:
- Install and run the Software on devices You own or control
- Use the Software for internal business purposes, tied to a valid PromptOwl account
- Make backup and archival copies
You may not:
- Redistribute, resell, rent, lease, or sublicense the Software
- Offer the Software as a hosted, managed, or software-as-a-service product to third parties
- Reverse engineer, decompile, or create derivative works
- Use the Software to build a competing product or service
- Remove copyright, trademark, or license notices
Full license text: LICENSE.md
For redistribution, hosted-service, OEM, or regulated-industry use, contact [email protected] for a commercial license agreement.
Platform terms
Because the Software requires a PromptOwl account, the following terms also apply to Your use:
- End User License Agreement — https://promptowl.ai/eula/
- Terms of Service — https://promptowl.ai/terms-of-service/
- Privacy Policy — https://promptowl.ai/privacy-policy/
- Acceptable Use Policy — https://promptowl.ai/acceptable-use/
- Disclaimer — https://promptowl.ai/disclaimer/
- Cookie Policy — https://promptowl.ai/cookies/
Support
- Documentation: https://promptowl.ai/contextnest/
- Product questions: https://promptowl.ai/contact-us/
- Support & bugs:
[email protected] - Commercial licensing:
[email protected](subject: ContextNest Commercial License)
AI output disclaimer
The Software injects content into large language models. AI output may be inaccurate, incomplete, or inappropriate for your use case. You are responsible for reviewing and validating any AI-generated content before relying on it, particularly in business-critical or regulated contexts. Do not deploy the Software in medical, legal, financial-advisory, or safety-critical environments without appropriate human oversight.
Copyright © 2026 Promptowl LLC. All rights reserved. "ContextNest" and "PromptOwl" are trademarks of Promptowl LLC.
Promptowl LLC · 3060 Mercer University Dr Ste 110 · Atlanta, GA 30341 · USA
