vibecheck

v1.0.2

A local MCP work ledger for coding agents to record project work, claims, and handoffs.

CodexClaude Code1 Skill1 MCP serverstdio

By Mike Davis0 GitHub starsUpdated 1 hour ago

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 2 skill or MCP entries
Source updated: Sep 26, 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 vibecheck for Codex and Claude Code

Installs for the current user

codex plugin marketplace add mgd34msu/vibecheck
codex plugin marketplace upgrade vibecheck
codex plugin add vibecheck@vibecheck

Paste and run these commands in a terminal with Codex. They add and refresh the vibecheck catalog, then install this plugin.

Compatibility: the page URL and API slug “vibecheck” remain stable.

Codex: vibecheck@agent-plugin-marketplace → vibecheck@vibecheck

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/mgd34msu/vibecheck

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

vibecheck/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/vibecheck/SKILL.md
└── .mcp.json

Included Skills1

vibecheckskills/vibecheck/SKILL.md

Use the Vibecheck MCP ledger to coordinate coding work, report project status, update a shared plan, or recover prior work and plan revisions. Applies when the user asks for Vibecheck or shared work tracking; it does not inspect repository contents or schedule agents.

MCP servers1

vibecheckstdio

command: bash
args: scripts/run-server.sh --transport stdio
cwd: .

Plugin manifests2

.codex-plugin/plugin.json

{
  "name": "vibecheck",
  "version": "1.0.2",
  "description": "A local MCP work ledger for coding agents to record project work, claims, and handoffs.",
  "author": {
    "name": "Mike Davis",
    "email": "[email protected]",
    "url": "https://github.com/mgd34msu"
  },
  "homepage": "https://github.com/mgd34msu/vibecheck#readme",
  "repository": "https://github.com/mgd34msu/vibecheck",
  "keywords": [
    "mcp",
    "project",
    "ledger",
    "coding-agents"
  ],
  "skills": "./skills/",
  "mcpServers": {
    "vibecheck": {
      "command": "bash",
      "args": [
        "scripts/run-server.sh",
        "--transport",
        "stdio"
      ],
      "cwd": "."
    }
  },
  "interface": {
    "displayName": "Vibecheck",
    "shortDescription": "A shared project work ledger for coding agents",
    "longDescription": "Record tasks, claims, dependencies, progress, and handoffs in a local SQLite ledger that coding agents can query through MCP.",
    "developerName": "Mike Davis",
    "category": "Productivity",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://github.com/mgd34msu/vibecheck",
    "defaultPrompt": [
      "Join this project's Vibecheck ledger and show its current status.",
      "Record this task in Vibecheck and check for conflicting claims.",
      "Use Vibecheck to leave a handoff for the next session."
    ]
  }
}

.claude-plugin/plugin.json

{
  "name": "vibecheck",
  "version": "1.0.2",
  "description": "A passive work ledger for coding agents.",
  "author": {
    "name": "Mike Davis",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/mgd34msu/vibecheck#readme",
  "repository": "https://github.com/mgd34msu/vibecheck",
  "mcpServers": {
    "vibecheck": {
      "command": "bash",
      "args": [
        "${CLAUDE_PLUGIN_ROOT}/scripts/run-server.sh",
        "--transport",
        "stdio"
      ]
    }
  }
}