Thesmos Governance

Real-time AI repo governance — inline findings, health scores, and adapter sync for Claude, Gemini, Cursor, Copilot, and Codex.

What It Does

Thesmos Governance enforces 1,075+ AI-coding rules across your repo — catching security risks, stale adapters, context drift, and bad AI patterns before they land in production. The extension surfaces findings inline in VS Code and keeps your AI assistant configurations in sync automatically.

Key capabilities:

Live Findings Panel — governance violations surface as you code, with severity badges (BLOCKER / HIGH / MEDIUM / LOW)
Health Score — a single 0–100 grade for your repo's governance state, visible in the status bar
AI Adapter Sync — regenerate Claude, Cursor, Copilot, and Gemini config files from one command
Autopilot — Claude Code session orchestration with journal, diff review, and one-click PR
Agent Scope — lock Claude Code to allowed paths and commands to prevent runaway AI edits
Token Budget — track and limit Claude Code token spend per session
Commit Lint — validate commit messages against Conventional Commits before push
Import Scan — supply-chain check for suspicious or unvetted npm packages
AI Debt Scanner — quantify and surface accumulated AI tech debt
Context Snapshot — capture project context for handoff to a fresh AI session
Vercel Lint — catch broken routes, missing env vars, and config issues in vercel.json

Installation

From VS Code Marketplace (recommended):

Open VS Code
Press Ctrl+Shift+X (or Cmd+Shift+X on Mac) to open Extensions
Search "Thesmos Governance"
Click Install

Or install via command line:

code --install-extension holley-studios.thesmos-governance-vscode

Requirements:

VS Code 1.85+
Node.js 20+
thesmos-governance npm package (auto-detected from node_modules/.bin or PATH)

Quick Start

Install the npm package in your project:

npm install --save-dev thesmos-governance

Initialize governance (creates .thesmos/config.json):
```
npx thesmos init
```
Open your project in VS Code — the Thesmos icon appears in the Activity Bar (Θ)
Click the Θ icon to open the Findings panel and run your first scan
Check your health score in the status bar — click it to see the full breakdown

Commands

Access all commands via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and type "Thesmos":

Command	Description
`Thesmos: Scan Repository`	Run a full governance scan
`Thesmos: Review Current File`	Check the active file against all rules
`Thesmos: Show Health Score`	View the 0–100 governance grade
`Thesmos: Regenerate AI Adapters`	Sync Claude, Cursor, Copilot, Gemini configs
`Thesmos: Open Config`	Edit `.thesmos/config.json`
`Thesmos: Refresh Findings`	Reload the findings panel
`Thesmos Autopilot: Generate Autopilot Plan`	Create a Claude Code autopilot plan
`Thesmos Autopilot: Review Session Diff (AI)`	AI review of the current autopilot session
`Thesmos Autopilot: Open Draft PR`	Open the PR for the current autopilot session
`Thesmos: Scan Imports (Supply Chain Check)`	Audit npm dependencies for supply-chain risks
`Thesmos: Scan AI Debt`	Quantify accumulated AI tech debt
`Thesmos: Snapshot Project Context`	Capture context for AI session handoff
`Thesmos: Show Context Health`	Review context freshness and drift
`Thesmos: Initialize Agent Scope`	Lock Claude Code to allowed paths/commands
`Thesmos: Show Agent Scope`	View current scope restrictions
`Thesmos: Show Token Usage Report`	Session token spend breakdown
`Thesmos: Lint Last Commit Message`	Validate against Conventional Commits
`Thesmos: Create Commit (Guided Wizard)`	Structured commit creation with type/scope guidance
`Thesmos: Lint Vercel Deployment Config`	Check vercel.json for common issues

Configuration

All settings are under Settings → Extensions → Thesmos Governance:

Setting	Default	Description
`thesmos.enable`	`true`	Enable/disable the extension
`thesmos.runOnSave`	`true`	Re-run review on every file save
`thesmos.debounceMs`	`1000`	Milliseconds to wait after save before re-analyzing
`thesmos.showStatusBar`	`true`	Show health score in the status bar
`thesmos.binaryPath`	`""`	Absolute path to thesmos binary (leave empty for auto-detect)
`thesmos.autoScan`	`false`	Auto-run scan on activation when no report exists
`thesmos.autopilot.baseBranch`	`"main"`	Base branch to diff against in autopilot review

Supported AI Platforms

Thesmos generates and validates adapter configurations for:

Platform	File
Claude Code	`.claude/settings.json`
Cursor	`.cursor/rules/`
GitHub Copilot	`.github/copilot-instructions.md`
Gemini	`GEMINI.md`
OpenAI Codex / AGENTS.md	`AGENTS.md`
Windsurf	`.windsurfrc`

License

MIT — see LICENSE

Thesmos Governance

holleystudio

Thesmos Governance

What It Does

Installation

Quick Start

Commands

Configuration

Supported AI Platforms

Links

License