Knowit — shared, structured memory for AI coding agents
Your agent forgets everything between sessions. Knowit fixes that.
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenKnowit is an open-source MCP server + CLI that gives AI coding agents a persistent, queryable project memory — shared across sessions, across teammates, and across every MCP client: Claude Code, Codex, Cursor, Windsurf, VS Code/Copilot, Gemini CLI, Kiro, Cline, Continue, Zed, and JetBrains AI Assistant.
Store architecture rules, decisions, and conventions once. Every agent retrieves the relevant context before it plans or edits code — no more re-explaining your codebase every session.
npx knowit install
That's it. The wizard configures your MCP clients and initializes a local, git-friendly memory store at .knowit/knowledge.jsonl.
🌐 Website: useknowit.dev · 📚 Docs: useknowit.dev/docs
knowit preview)Knowit is designed for operational engineering memory: the durable context agents need while doing code work.
That means memory is stored with structure such as:
rule, architecture, pattern, decision, convention, noteglobal, team, repo, domainThis makes it easier for agents to retrieve only the context that matters for the current task, such as:
The default project storage is .knowit/knowledge.jsonl, a line-delimited JSON file that is readable, reviewable, and friendly to git diffs. Global and custom storage scopes can still use SQLite when you want a private local database or a shared database path.
npx knowit install
Requires Node.js 20+. No global install needed — the wizard runs via npx and can install knowit globally for you if you want faster future starts.
Knowit's CLI also checks for newer published versions and shows a non-blocking update notice in interactive terminal sessions.
npx knowit install
npx knowit install is the main setup flow. It can:
This repository intentionally keeps a checked-in .mcp.json so Knowit can use itself while developing Knowit. For normal consumer projects, prefer generating MCP config through knowit install.
If you are not using the installer-managed instructions, add this to the client instruction file such as AGENTS.md, CLAUDE.md, or .github/copilot-instructions.md:
## Memory
This project uses Knowit as the default persistent knowledge base for AI coding agents.
- Before planning or implementing, call `resolve_context` with the task description and repo name.
- After finishing a task, call `capture_session_learnings` to store durable rules, decisions, and patterns.
- Prefer Knowit over repo-local markdown memory files unless the user explicitly asks for a file.
Knowit uses npx -y knowit@latest serve for generated MCP configs when the knowit binary is not installed globally. Project installs do not set KNOWIT_DB_PATH; they rely on the client working directory and the project-local .knowit/knowledge.jsonl store.
knowit add rule "No direct DB access from controllers" \
"All database access goes through repository classes." \
--scope repo --repo api-gateway --tags architecture,layers
knowit resolve "implement user authentication" --repo api-gateway --domain auth
Agents interact with Knowit through MCP tools:
resolve_context.capture_session_learnings.That keeps source code in the repo and long-lived project memory in Knowit.
In practice, Knowit is a layer for execution context:
knowit preview)See exactly what your agents remember:
npx knowit preview
This opens a local, read-only web UI (default 127.0.0.1:4077) for browsing your knowledge base:
Useful for auditing what agents have stored, reviewing team memory before committing .knowit/knowledge.jsonl, and demoing the knowledge base.
ARCHITECTURE.md, ADR, and process notes.# Setup
npx knowit install
knowit install # if already installed globally
knowit init
# Add and search knowledge
knowit add rule "Use repository classes" "No direct DB access from controllers."
knowit search "repository pattern"
knowit resolve "add webhook retry handling" --repo api-gateway --domain billing
# Browse entries
knowit list --repo api-gateway
knowit show <entry-id>
knowit stats
knowit preview # local web UI for browsing memory
# Sources
knowit source list
knowit source connect notion
knowit source show notion
# Cloud account commands
knowit cloud login --token <token>
knowit cloud whoami
knowit cloud logout
# Import existing markdown knowledge
knowit import-md --yes
# Convert an existing project SQLite database to JSONL
knowit migrate-storage --sqlite-path .knowit/knowit.db --dry-run
knowit migrate-storage --sqlite-path .knowit/knowit.db
Entries also support tags, optional URLs, metadata, confidence scores, and a structured body field for reader UIs. content remains the plain searchable text; body is the renderable version. When body is omitted, Knowit derives paragraph blocks from content.
Knowit is local-first. In project scope, .knowit/knowledge.jsonl is the canonical memory file and can be reviewed in version control like source code.
Existing projects with .knowit/knowit.db are migrated automatically on first project-scope initialization when .knowit/knowledge.jsonl does not exist. You can also run the conversion explicitly:
knowit migrate-storage --sqlite-path .knowit/knowit.db --dry-run
knowit migrate-storage --sqlite-path .knowit/knowit.db
The command writes .knowit/knowledge.jsonl and .knowit/sources.json. It refuses to overwrite existing targets unless you pass --force.
For private global memory or a shared database outside the repo, point everyone at the same SQLite database path.
KNOWIT_DB_PATH=/shared/team/knowit.db npx knowit install --scope global --client claude
That gives every developer and every agent the same durable memory source without adding a hosted dependency.
If you set OPENAI_API_KEY, Knowit adds embeddings-backed semantic search. Without it, Knowit still works with text and tag matching.
export OPENAI_API_KEY=sk-...
knowit search "how do we handle payment retries"
Knowit can connect to Notion as an external source and route agents to the right MCP flow when durable docs belong there.
knowit source connect notion
Knowit's interactive CLI commands use update-notifier to let users know when a newer npm release is available.
knowit serve so MCP stdio traffic stays clean.NO_UPDATE_NOTIFIER=1 or by passing --no-update-notifier.The current public release is focused on the open-source, local-first workflow. Hosted cloud plans are not publicly enabled right now.
Issues, README improvements, bug reports, feature requests, and pull requests are welcome.
If you are trying Knowit in a real project, feedback about agent workflows, missing MCP tools, and setup friction is especially useful.
MIT. See LICENSE.
Shared, structured memory for AI coding agents — MCP server + CLI. One memory layer for Claude Code, Codex, Cursor & every MCP client.
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Knowit läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. Shared, structured memory for AI coding agents — MCP server + CLI. One memory layer for Claude Code, Codex, Cursor & every MCP client.