Quick Start

Get your governance system running in under 5 minutes.

Initialize a Project

Run the interactive init command in your project directory:

bashcd /path/to/your-project
governix init --interactive --dir .

This creates a .governance/ directory with all 22 AI roles, governance rules, baseline files, and templates.

Check Governance Status

Verify that your governance framework is healthy:

bashgovernix status --dir .
Output:
  Role Status:     22/22 active
  Rule Compliance: 100%
  Heartbeat:       OK
  Last Updated:    2026-07-30 16:14 UTC

Start the Web Dashboard

Launch the built-in governance dashboard:

bashgovernix dashboard --port 8080
2026/07/30 16:20:00 Dashboard available at http://localhost:8080

Open http://localhost:8080 in your browser to see the governance health overview, role list, and real-time status.

Integrate with Your AI IDE

Add the MCP Server to Cursor/Windsurf configuration:

json{
  "mcpServers": {
    "governix": {
      "command": "/path/to/governix-mcp",
      "args": [],
      "env": {
        "GOVERNANCE_PATH": "/path/to/your-project"
      }
    }
  }
}

Now your AI assistant can read governance rules, check compliance, and provide governance-aware suggestions.

Command Reference

Command	Description
`governix init`	Initialize governance framework
`governix status`	Check governance health
`governix dashboard`	Start web dashboard
`governix version`	Show version info