Pituitary

Created By

autholykosa month ago

Catch spec drift before it catches you. Pituitary indexes your specs, docs, and decision records, then detects overlap, contradictions, stale docs, and code that drifts from what was decided. 6 tools for spec-aware AI workflows: - search_specs: semantic search across indexed spec sections - check_overlap: detect specs that cover overlapping ground - compare_specs: side-by-side tradeoff analysis of two specs - analyze_impact: trace which specs, docs, and code paths are affected when a spec changes - check_doc_drift: find docs that contradict accepted specs - review_spec: full composite review (overlap + comparison + impact + drift + remediation) Single Go binary. One SQLite file. No API keys required. Deterministic by default.

# spec-drift

# context-rot

Overview Content Tools Comments

Content

What it does

Point Pituitary at your repo. It indexes your specs, docs, and decision records, then catches what you can't track by hand. What you wrote down should still be true. Pituitary makes sure it is.

Tools

Tool	Description
search_specs	Semantic search across indexed spec sections. Filter by domain and status.
check_overlap	Detect specs that cover overlapping ground. Returns similarity scores and relationship classification.
compare_specs	Side-by-side tradeoff analysis of two specs.
analyze_impact	Trace which specs, code refs, and docs are affected when a spec changes.
check_doc_drift	Find docs that have gone stale relative to accepted specs, with cited evidence.
review_spec	Full composite review: overlap + comparison + impact + drift + remediation.

Requirements

Pituitary binary on PATH (download from GitHub Releases)
A config file (generate one with pituitary init --path .)
A built index (pituitary index --rebuild)

No API keys required in deterministic mode.

Use cases

PR review: Agent calls check_overlap and analyze_impact when a PR touches specs or decision records
Pre-merge drift check: Agent calls check_doc_drift to surface stale docs before merging
Decision authoring: Agent calls review_spec to get a full assessment of a new or changed spec
Impact questions: "What specs and docs would be affected if I change the auth middleware?" triggers analyze_impact

Server Config

{
  "mcpServers": {
    "pituitary": {
      "command": "pituitary",
      "args": [
        "serve",
        "--config",
        ".pituitary/pituitary.toml"
      ]
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

Tavily Mcp

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Playwright McpPlaywright MCP server

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

CursorThe AI Code Editor

DeepChatYour AI Partner on Desktop

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Amap Maps高德地图官方 MCP Server