vibe-cognition
v0.37.0Project knowledge graph — captures decisions, failures, discoveries, patterns, and reasoning chains. Fully local, no API keys.
By Colton DyckLicense: MIT3 GitHub starsUpdated last week
Directory evidence
- Runtimes
- Codex and Claude Code
- Parsed components
- 7 skill or MCP entries
- Source updated
- Sep 12, 2026
- Manifest status
- Canonical path parsed
The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →
Install vibe-cognition for Codex and Claude Code
codex plugin marketplace add Haagndaazer/vibe-cognition
codex plugin marketplace upgrade vibe-cognition-dev
codex plugin add vibe-cognition@vibe-cognition-devPaste and run these commands in a terminal with Codex. They add and refresh the vibe-cognition-dev catalog, then install this plugin.
Compatibility: the page URL and API slug “vibe-cognition” remain stable.
- Codex:
vibe-cognition@agent-plugin-marketplace→vibe-cognition@vibe-cognition-dev
The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.
Get the source manually
git clone https://github.com/Haagndaazer/vibe-cognitionClone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.
Plugin files
├── .codex-plugin/plugin.json├── .claude-plugin/plugin.json├── skills/vibe-backfill/SKILL.md├── skills/vibe-cognition/SKILL.md├── skills/vibe-curate/SKILL.md├── skills/vibe-dashboard/SKILL.md├── skills/vibe-document/SKILL.md├── skills/vibe-workflow/SKILL.md└── .mcp.json
Included Skills6
Find git commits without corresponding cognition episodes and create nodes for them. Run this to backfill the cognition graph with commit history.
You MUST use this skill any time you need to retrieve information about the project or write project history to persistent memory, retrieving project information without using this skill will affect the clarity of the research. You must also use this skill when storing memories about the project. Curation is YOUR job to TRIGGER — after recording any nodes you MUST run the /vibe-curate skill (launches the background curator); never author semantic edges yourself.
Launch the background curator that links new memories — semantic edges (led_to, resolved_by, supersedes, contradicts, relates_to) and cluster summary nodes. Use after recording new nodes, or when the graph has uncurated nodes. Curation itself runs in a background curate-orchestrator agent; this skill's only job is to launch it and report back.
Launch the Vibe Cognition dashboard — a local web viewer for the project's cognition graph with embedding-powered search. Use when the user asks to open/show/launch the dashboard, the cognition graph viewer, or the project graph.
You MUST use this skill whenever you store a document (a client doc, PDF, spec, contract, report, transcript) as project memory, or retrieve/attach one. Storing a document is only half the job — the knowledge inside it connects to the graph ONLY when you record its facts as descriptor nodes that cite the document's returned doc_ref in THEIR references. This skill makes that workflow the default; skipping it leaves an inert, disconnected document. Curation is YOUR job to TRIGGER — after recording descriptor nodes you MUST run /vibe-curate (launches the background curator); never author semantic edges yourself.
You MUST use this skill whenever you work out a reusable multi-step procedure worth repeating (deploy steps, onboarding, release process, debugging runbook) — record it as a first-class `workflow` node so the full how-to is fetched whole next time, not reconstructed from scattered nodes or re-worked-out from memory. You MUST also use this skill BEFORE starting any multi-step task, to check cognition_get_workflow for an existing procedure first — skipping this retrieval check means silently reinventing a workflow that already exists. A workflow is versioned by supersession, never edited in place; this skill covers recording, retrieving, and updating one.
MCP servers1
- command
- uv
- args
- run --no-sync --directory ${CLAUDE_PLUGIN_ROOT} python -m vibe_cognition.server
- env.REPO_PATH
- ${CLAUDE_PROJECT_DIR}
- env.VIBE_DATA_DIR
- ${CLAUDE_PLUGIN_DATA}
- env.UV_PROJECT_ENVIRONMENT
- ${CLAUDE_PLUGIN_DATA}/.venv
MCP configuration uses runtime-provided plugin path placeholders such as ${PLUGIN_ROOT} or ${CLAUDE_PLUGIN_ROOT}. Review the manifest for the runtime-specific expansion rules.
Plugin manifests2
{
"name": "vibe-cognition",
"version": "0.37.0",
"description": "Project knowledge graph — captures decisions, failures, discoveries, patterns, and reasoning chains. Fully local, no API keys.",
"keywords": [
"knowledge-graph",
"cognition",
"project-memory",
"mcp",
"local"
],
"skills": [
"./adapters/codex/skills/vibe-cognition",
"./adapters/codex/skills/vibe-document",
"./adapters/codex/skills/vibe-workflow",
"./adapters/codex/skills/vibe-dashboard",
"./adapters/codex/skills/vibe-curate",
"./adapters/codex/skills/vibe-backfill"
],
"hooks": [
"./adapters/codex/hooks.json"
],
"interface": {
"displayName": "Vibe Cognition",
"shortDescription": "Durable project memory: decisions, failures, discoveries, tasks, workflows.",
"longDescription": "Maintains a per-project knowledge graph as an MCP server. On Codex the plugin's session-start hook registers the server with `codex mcp add` (restart Codex once after install), injects a project digest at session start, and re-injects the standing practices after compaction.",
"developerName": "Colton Dyck",
"category": "Other"
}
}{
"name": "vibe-cognition",
"version": "0.37.0",
"description": "Project knowledge graph — captures decisions, failures, discoveries, patterns, and reasoning chains. Fully local, no API keys.",
"author": {
"name": "Colton Dyck"
},
"license": "MIT",
"repository": "https://github.com/Haagndaazer/vibe-cognition",
"keywords": [
"knowledge-graph",
"cognition",
"project-memory",
"mcp",
"local"
],
"mcpServers": {
"vibe-cognition": {
"command": "uv",
"args": [
"run",
"--no-sync",
"--directory",
"${CLAUDE_PLUGIN_ROOT}",
"python",
"-m",
"vibe_cognition.server"
],
"env": {
"REPO_PATH": "${CLAUDE_PROJECT_DIR}",
"VIBE_DATA_DIR": "${CLAUDE_PLUGIN_DATA}",
"UV_PROJECT_ENVIRONMENT": "${CLAUDE_PLUGIN_DATA}/.venv"
}
}
}
}For maintainers
If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.
[vibe-cognition on Agent Plugins Marketplace](https://pluginsmp.com/plugins/vibe-cognition)