Agent Plugins Marketplace
All plugins

vibe-cognition

v0.37.0

Project knowledge graph — captures decisions, failures, discoveries, patterns, and reasoning chains. Fully local, no API keys.

CodexClaude Code6 Skills1 MCP serverstdio

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

Installs for the current user
codex plugin marketplace add Haagndaazer/vibe-cognition
codex plugin marketplace upgrade vibe-cognition-dev
codex plugin add vibe-cognition@vibe-cognition-dev

Paste 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-marketplacevibe-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-cognition

Clone 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

vibe-cognition/
├── .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

vibe-backfillskills/vibe-backfill/SKILL.md

Find git commits without corresponding cognition episodes and create nodes for them. Run this to backfill the cognition graph with commit history.

vibe-cognitionskills/vibe-cognition/SKILL.md

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.

vibe-curateskills/vibe-curate/SKILL.md

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.

vibe-dashboardskills/vibe-dashboard/SKILL.md

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.

vibe-documentskills/vibe-document/SKILL.md

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.

vibe-workflowskills/vibe-workflow/SKILL.md

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

vibe-cognitionstdio
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

.codex-plugin/plugin.json
{
  "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"
  }
}
.claude-plugin/plugin.json
{
  "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"
      }
    }
  }
}

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)