Claude Hangar

Why Claude Hangar?

Most Claude Code configs are personal dotfiles — useful to read, hard to reuse. Claude Hangar is different:

• One command deploys a complete, tested setup to ~/.claude/
• Multi-project orchestration — manage configs for multiple repos from one place
• Modular stacks — pick only what you need (bash integrate.sh <stack>) with --with/--without component control
• Battle-tested hooks that prevent real incidents (secret leaks, destructive commands, context overflow)
• 42 skills from project scanning to pre-PR verification, context optimization, session recap, effort tuning, stack lenses, and meta-governance
• 31 lifecycle hooks with 4-level quality gates, config protection, MCP health checks, design quality guards, permission-request inspection, budget caps, and smart context preservation
• 22 agents for specialized tasks (code review, TDD enforcement, performance analysis, MCP server development, autonomous workflows) — deep-reasoning agents run at effort: xhigh (v2.1.111+)
• 20 governance rules (common + language-specific) always-on code quality
• 3 context modes — dev, research, review
• Cross-platform — Linux, macOS, and Windows (Git Bash)

Prerequisites

• Node.js >= 18 LTS (for hook JSON parsing via node -e)
• Bash >= 4.0 (Git Bash on Windows, native on macOS/Linux)
• Git >= 2.20
• GitHub CLI (gh) — optional, for GitHub stack features and freshness checks

Quick Start

One-liner install:

curl -fsSL https://raw.githubusercontent.com/claude-hangar/claude-hangar/main/install.sh | bash

Or clone manually:

git clone https://github.com/claude-hangar/claude-hangar.git ~/.claude-hangar
cd ~/.claude-hangar && bash setup.sh

  Claude Hangar — Setup
  ─────────────────────

[i] Running on: linux
[+] Prerequisites: git ✓  node ✓
[+] Structure validation passed
[i] Deploying to /home/user/.claude/...
[+] Deployed: Hooks (31 scripts)
[+] Deployed: Agents (22 definitions)
[+] Deployed: Skills (41 commands)
[+] Deployed: Shared lib
[+] Deployed: Statusline
[+] Deployed: settings.json (from template)

[+] Deployment complete!
[i] Open Claude Code in any project to start.

What You Get

Hooks (27) — Automated Safety Net

MCP Server — Hangar State API

A zero-dependency MCP server (core/mcp-server/server.js) that exposes Hangar configuration state as 5 read-only tools: hangar_hooks, hangar_skills, hangar_agents, hangar_config, hangar_freshness.

Shared References (3)

Shared behavioral files that skills and agents reference for consistency:

Agents (21) — Specialized AI Workers

Skills (31) — Slash Commands for Real Work

Stacks (9) — Framework & Tool Extensions

Drop-in extensions for your specific tech stack. Full stacks provide CLAUDE.md.snippet + audit skills. MCP stacks provide tool integrations.

Templates

• 5 project templates — CLAUDE.md starters (minimal, web, fullstack, management) + DECISIONS.md (ADR register)
• 6 CI/CD templates — GitHub Actions for Node.js, Python, VPS (GHCR), Docker Compose, GitHub Pages, Cloudflare Pages
• Global CLAUDE.md template — Baseline instructions with {{PLACEHOLDER}} customization

Multi-Project Orchestration

Manage Claude Code configs for multiple repositories from one registry.json:

{
  "projects": [
    {
      "name": "website",
      "repo": "my-org/website",
      "defaultPath": "~/projects/website",
      "skills": ["audit", "astro"],
      "workflows": ["ci-node.yml", "deploy-ghpages.yml"]
    },
    {
      "name": "api",
      "repo": "my-org/api",
      "defaultPath": "~/projects/api",
      "skills": ["audit", "database", "auth"],
      "workflows": ["ci-node.yml", "deploy-vps-ghcr.yml"]
    }
  ]
}

Each project gets the right CLAUDE.md, stack-specific skills, and CI templates — all from one source of truth.

→ Multi-Project Guide

Repository Structure

Documentation

Works Great With

Claude Hangar is the infrastructure layer. These companion tools extend it:

All are compatible with Hangar and each other. No conflicts, no overlap.

→ Companion Tools Guide

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Areas where contributions are especially valued:

• New stacks — Rails, Django, Go, Rust, Laravel, ...
• Skills — Share your workflow automations
• Translations — Help us reach more developers (i18n guide)
• Bug reports — Issues with specific OS/shell combinations

Inspired By

• Everything Claude Code — Rules system, language agents, learning mechanisms, context modes, hook profiles, config protection, meta-governance, shared references
• GSD v2 — DECISIONS.md (append-only ADR register) pattern
• BMAD-METHOD — Story continuity, intent cascade patterns
• spec-kit — User-invocable frontmatter, argument hints
• oh-my-opencode — Agent fallback, hook composition patterns
• ui-ux-pro-max-skill — Design token architecture, product palettes

License

MIT — Use it, fork it, extend it.