sirsi-pantheon

README

🏛️ Sirsi Pantheon

Unified DevOps Intelligence Platform by Sirsi Technologies — One Install, All Deities.

"One Install. All Deities."

Sirsi Pantheon is a unified DevOps intelligence platform that brings together every deity in the Sirsi ecosystem into a single, lightweight binary. Install once, get infrastructure hygiene, QA/QC governance, persistent AI knowledge, and more.

𓇶 The Hypervisor

Glyph	Deity	Domain	What It Does
𓇶	Ra	Supreme Overseer	The boss — orchestrates all deities automatically (planned)

𓁯 The Weaver

Glyph	Deity	Domain	What It Does	Dependencies
𓁯	Net (Neith)	The Weaver	Architecture documentation and decision records	None

𓀭 The Code Gods (Governance & Knowledge)

Decision-making, standards, memory, and healing.

Glyph	Deity	Roles	What It Does	Dependencies
𓁟	Thoth	God of Knowledge	Cuts AI token waste by 98% via persistent memory	None
𓆄	Ma'at	Goddess of Order	Grades code quality and enforces team standards	None
𓁐	Isis	The Healer	Autonomous remediation engine — fixes Ma'at findings (lint, vet, formatting)	Ma'at
𓁆	Seshat	Goddess of Writing	Universal knowledge grafting engine — ingests from Gemini, Claude, Chrome, Apple Notes, Google Workspace; exports to Thoth, GEMINI.md, NotebookLM	Thoth

𓀰 The Machine Gods (Infrastructure & OS)

Infrastructure hygiene, safety, and hardware flow.

Glyph	Deity	Domain	What It Does	Dependencies
𓃣	Anubis	Judge of Hygiene	Finds junk on your computer that cleaning apps miss	Horus
𓂓	Ka	Spirit Hunter	Detects apps you deleted that are still secretly running	Horus
𓁵	Sekhmet	Warrior Guardian	Watchdog: kills runaway processes & NPU acceleration	Hapi
𓂀	Horus	The All-Seeing Eye	Shared storage index: walk once, query forever	None
𓆣	Khepri	The Scarab	Network discovery and container audit scavenger	None
𓁶	Hapi	God of the Flow	Detects GPUs, ANE, and hardware accelerators	None
𓇼	Seba	Star Map	Draws a visual map of your infrastructure topology	Khepri
𓉡	Hathor	Goddess of Dedup	Mirror: Finds duplicate files eating your storage	None

---

⚡ Installation — All Platforms & Methods

Not sure which tool to use? See the FAQ: Which Pantheon Tool Should I Use?

CLI (macOS / Linux)

# Homebrew (recommended)
brew tap SirsiMaster/tools && brew install sirsi-pantheon

# From source (requires Go 1.22+)
go install github.com/SirsiMaster/sirsi-pantheon/cmd/pantheon@latest

# Or clone and build
git clone https://github.com/SirsiMaster/sirsi-pantheon.git
cd sirsi-pantheon && go build -o pantheon ./cmd/pantheon/

# Install individual deities
brew install SirsiMaster/tools/pantheon-anubis    # Infrastructure hygiene only
brew install SirsiMaster/tools/pantheon-maat      # Code quality only
brew install SirsiMaster/tools/pantheon-thoth     # AI memory only

CLI (Windows)

# From source (requires Go 1.22+)
go install github.com/SirsiMaster/sirsi-pantheon/cmd/pantheon@latest

# Or download binary from GitHub Releases
# https://github.com/SirsiMaster/sirsi-pantheon/releases

VS Code Extension (macOS / Linux / Windows)

Search "Pantheon" in your extension marketplace, or:

# VS Code
code --install-extension SirsiMaster.sirsi-pantheon

# Antigravity / Cursor / Windsurf — works on any VS Code-based IDE
# Also available on OpenVSX: https://open-vsx.org/extension/SirsiMaster/sirsi-pantheon

Menu Bar App (macOS only)

# Build from source
go build -o /opt/homebrew/bin/pantheon-menubar ./cmd/pantheon-menubar/

# Auto-start at login
cp cmd/pantheon-menubar/bundle/ai.sirsi.pantheon.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/ai.sirsi.pantheon.plist

MCP Server (any platform with AI IDE)

pantheon mcp    # Starts JSON-RPC 2.0 server over stdio

See MCP Configuration below.

Binary Sizes

Component	Download	On Disk
CLI (pantheon)	6.6 MB	12 MB
Menu Bar (pantheon-menubar)	2.6 MB	4.5 MB
Extension (.vsix)	40 KB	40 KB
Agent (pantheon-agent)	~1.2 MB	2.1 MB

---

Getting Started

Get up and running in under a minute. For the full walkthrough, see the Getting Started Guide.

# 1. Install
brew tap SirsiMaster/tools && brew install sirsi-pantheon

# 2. Scan your machine for waste
pantheon scan

# 3. Find ghost apps and duplicates
pantheon ghosts
pantheon dedup ~/Documents

# 4. Set up AI memory in a project
cd ~/my-project && pantheon thoth init && pantheon thoth sync

# 5. Audit code quality and auto-fix
pantheon maat audit
pantheon maat heal

---

Scan Your Machine

pantheon scan                    # Find infrastructure waste (caches, build artifacts, orphaned files)
pantheon scan --all              # Scan all categories
pantheon scan --json             # Machine-readable output

Find Ghost Apps

pantheon ghosts                  # Detect remnants of uninstalled applications
pantheon ghosts --sudo           # Include system directories

Find Duplicate Files

pantheon dedup ~/Downloads ~/Desktop  # Scan directories for duplicates

Monitor Resources

pantheon guard                   # System resource monitoring and memory pressure

AI Project Memory

pantheon thoth init              # Initialize .thoth/ knowledge system
pantheon thoth sync              # Sync memory from source + git history
pantheon thoth compact -s "..."  # Persist session decisions before context compression

Start MCP Server (any AI IDE)

pantheon mcp                     # JSON-RPC 2.0 over stdio — works with Claude, Cursor, Windsurf

Run Governance Audit

pantheon maat audit              # Coverage governance across all modules
pantheon maat audit --skip-test  # Use cached coverage (instant)

---

Commands

Core (what most users need)

Command	Description
pantheon scan	Scan for infrastructure waste (caches, build artifacts, orphaned files)
pantheon ghosts	Detect remnants of uninstalled applications
pantheon dedup [dirs...]	Find duplicate files across directories
pantheon guard	Monitor system resources and memory pressure
pantheon mcp	Start MCP server for AI IDE integration
pantheon thoth init	Initialize AI project memory (.thoth/)
pantheon thoth sync	Sync project memory from source + git
pantheon thoth compact	Persist session decisions before context compression
pantheon maat audit	Governance and coverage auditing
pantheon version	Show version

Global Flags

--json      # JSON output for scripting
--quiet     # Suppress non-essential output
--verbose   # Debug logging

---

🏛 Architecture

Pantheon is built on modules named after Egyptian mythology. Every deity maintains its identity while sharing a unified runtime:

Module	Deity	Role	Status
Jackal	Anubis	Scan engine — 64 rules across 7 domains	✅
Cleaner	𓃣 Anubis	Safe deletion with Trash + SHA-256 verification	✅
Ka	𓂓 Ka	Ghost app detection — 17 macOS locations	✅
Mirror	𓉡 Hathor	File dedup — 27x faster than naive hashing	✅
Guard	𓁵 Sekhmet	RAM audit, zombie process management	✅
Sight	𓂀 Horus	Launch Services + Spotlight repair	✅
Horus	𓂀 Horus	Shared filesystem index — walk once, query forever	✅
Hapi	𓁶 Hapi	GPU/Neural Engine/VRAM detection	✅
Scarab	𓆣 Khepri	Network discovery + container audit	✅
Brain	𓁟 Thoth	On-demand model downloader + classifier	✅
MCP	𓁟 Thoth	MCP server for AI IDE integration	✅
Scales	𓆄 Ma'at	YAML policy engine + enforcement	✅
Ma'at	𓆄 Ma'at	Coverage, canon, pipeline assessments	✅
Seba	𓇼 Seba	Infrastructure topology graph	🚧
Seshat	𓁆 Seshat	Universal knowledge grafting engine	✅
Isis	𓁐 Isis	Autonomous remediation (lint, vet, fmt)	✅
Neith	𓁯 Net	Architecture docs and decision records	✅

---

Scan Domains (64 Rules)

Domain	Examples
🖥️ General Mac	Caches, logs, crash reports, browser junk, downloads
🐳 Virtualization	Parallels, Docker, VMware, UTM, VirtualBox
📦 Dev Frameworks	Node/npm, Next.js, Rust/Cargo, Go, Python/conda, Java/Gradle
🤖 AI/ML	Apple MLX, Metal, NVIDIA CUDA, HuggingFace, Ollama, PyTorch
🛠️ IDEs & AI Tools	Xcode, VS Code, JetBrains, Claude Code, Codex, Gemini CLI
☁️ Cloud/Infra	Docker, Kubernetes, nginx, Terraform, gcloud, Firebase
📱 Cloud Storage	OneDrive, Google Drive, iCloud, Dropbox

---

🧠 Neural Brain

Pantheon includes an on-demand neural classification engine:

pantheon install-brain             # Download CoreML/ONNX model
pantheon install-brain --update    # Check for latest version
pantheon install-brain --remove    # Self-delete weights

The brain classifies files into 9 categories: junk, project, config, model, data, media, archive, essential, unknown. Currently ships with a heuristic classifier; neural model backends (ONNX Runtime, CoreML) are in development.

---

🔌 MCP Server — AI IDE Integration

Pantheon doubles as a context sanitizer for AI coding assistants:

pantheon mcp    # Start MCP server (stdio)

Configure Claude Code

// ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "pantheon": {
      "command": "pantheon",
      "args": ["mcp"]
    }
  }
}

Configure Cursor / Windsurf

// .cursor/mcp.json
{
  "mcpServers": {
    "pantheon": {
      "command": "pantheon",
      "args": ["mcp"]
    }
  }
}

MCP Tools

Tool	Description
scan_workspace	Scan a directory for infrastructure waste
ghost_report	Detect remnants of uninstalled applications
health_check	System health summary (cached, <10ms response)
thoth_read_memory	Load project context without reading source files
thoth_sync	Sync project memory from source + git history
detect_hardware	CPU, GPU, Neural Engine, and accelerator detection

---

𓁟 Thoth — Persistent Knowledge System

Thoth gives AI assistants persistent memory across sessions. Instead of re-reading thousands of lines of source code every time, the AI reads a ~100-line memory file for instant context.

.thoth/
├── memory.yaml      # Layer 1: WHAT — compressed project state
├── journal.md       # Layer 2: WHY — timestamped reasoning
└── artifacts/       # Layer 3: DEEP — benchmarks, audits, reviews

Measured Impact (Dogfooding on This Repo)

Metric	Without Thoth	With Thoth	Savings
Lines read at startup	22,958	297	98.7% fewer
Tokens consumed	275,496	3,564	271,932 saved
Context window used	137.7% (⚠️ doesn't fit)	1.7%	136% preserved
Cost per session (Opus 4)	$4.13	$0.05	$4.08 saved

We built Thoth because our own AI sessions were failing — the codebase was too large to fit in context. The before/after is measurable. Read the case study →

---

🪶 Ma'at — QA/QC Governance

Ma'at ensures every change meets quality standards:

pantheon maat                    # Full governance assessment
pantheon maat --coverage         # Test coverage thresholds
pantheon maat --canon            # Canon document verification
pantheon maat --pipeline         # CI pipeline health
pantheon maat --json             # Machine-readable output

57 tests, 3 governance domains, per-module threshold enforcement.

---

𓁆 Seshat — Universal Knowledge Grafting

Seshat ingests knowledge from multiple sources and exports it to any target in the Sirsi ecosystem.

Chrome Profile Ingestion

pantheon seshat ingest --source chrome                    # Default Chrome profile
pantheon seshat ingest --source chrome --profile "Work"   # Named profile
pantheon seshat ingest --source chrome --all-profiles     # All Chrome profiles
pantheon seshat profiles --source chrome                  # List available profiles

Supported Sources

• Chrome — bookmarks, history, saved tabs (per-profile or all profiles)
• Gemini — conversation exports
• Claude — session memory
• Apple Notes — local note ingestion
• Google Workspace — Docs, Sheets, Drive

Export Targets

• Thoth — merge into .thoth/memory.yaml for AI context
• GEMINI.md — export as Gemini-compatible project memory
• NotebookLM — export for Google NotebookLM ingestion

pantheon seshat export --target notebooklm --output ./export/
pantheon seshat export --target thoth
pantheon seshat export --target gemini

---

⚖️ Policy Enforcement

Define infrastructure hygiene policies in YAML:

api_version: v1
policies:
  - name: workstation-hygiene
    rules:
      - id: waste-limit
        metric: total_size
        operator: gt
        threshold: 20
        unit: GB
        severity: fail
        remediation: Run 'pantheon judge --confirm'

pantheon scales enforce                      # Run default policies
pantheon scales enforce -f custom-policy.yaml # Custom policies
pantheon scales validate -f policy.yaml      # Syntax check

---

🪞 Mirror — File Deduplication

Mirror finds duplicate files across any directory using a three-phase scan:

1. Size grouping — instant elimination of unique file sizes
2. Partial hash — SHA-256 of first 4KB + last 4KB (8KB per file)
3. Full hash — complete SHA-256 only for files that pass both phases

Why This Matters

Metric	Naive approach	Pantheon Mirror
56 candidate files (97.8 MB)	Reads all 97.8 MB	Reads 448 KB partial, then only matched files
Disk I/O	97.8 MB	< 2 MB
Time	84 ms	3 ms
Speedup	1x	27.3x
I/O reduction	—	98.8%

Benchmarked on real ~/Downloads directory, March 2026.

---

🛡️ Product Tiers

Tier	Scope	Price
Pantheon Free	Single workstation, all commands, Mirror GUI + CLI	Free forever
Pantheon Pro	Neural brain, importance ranking, semantic search	$9/mo
Eye of Horus	Subnet sweep (< 100 nodes)	$29/mo
Ra	Enterprise fleet, SAN/NAS, compliance	Contact

---

🔒 Security & Privacy

• Rule A11: No Telemetry — zero analytics, tracking, or data collection
• Rule A1: Safety First — all destructive ops require --confirm or --dry-run
• Rule A3: Fixed Agent Commands — agent has no shell access
• Trash-first cleaning — every removal goes to Trash with full decision log
• 35 protected paths — system dirs, user content dirs, keychains, and SSH keys are hardcoded as undeletable
• --stealth mode — Pantheon comes, judges, and vanishes (zero footprint)
• All scanning is local — no data leaves your machine

---

🛠️ Development

Setup

git clone https://github.com/SirsiMaster/sirsi-pantheon.git
cd sirsi-pantheon
git config core.hooksPath .githooks    # Enable pre-push gate
go build ./...

Pre-Push Gate — Tiered Depth

Every git push runs a quality gate. The default is fast (~10-30 seconds). Set MAAT_DEPTH to control how deep the gate checks:

Tier	Time	What Runs	When to Use
fast (default)	~10-30s	gofmt + go vet + build + tests on changed packages only	Every push
standard	~60-90s	Fast + Ma'at coverage/canon on changed packages	Before PR merge
deep	~3-5 min	Standard + full test suite + full Ma'at assessment	Pre-release only

git push                          # fast (default) — seconds, not minutes
MAAT_DEPTH=standard git push      # standard — adds Ma'at on changed pkgs
MAAT_DEPTH=deep git push          # deep — full suite (pre-release)
git push --no-verify              # skip gate entirely (use sparingly)

Why tiered? The full Ma'at + test suite takes 3-5 minutes and floods the IDE with terminal output, causing IPC starvation on Electron-based editors. The fast tier runs only what's relevant to your change. CI still runs the full deep suite on every push — the local gate catches the 95% case in seconds.

Adding Scan Rules

Implement the ScanRule interface in internal/jackal/rules/. See CONTRIBUTING.md for full guidelines.

---

🔌 VS Code Extension — Always-On Guardian

The Pantheon extension brings Guardian auto-renice, memory GC, and live metrics into your IDE.

Feature	Description
Guardian Auto-Renice	Deprioritizes LSP processes (gopls, tsserver, rust-analyzer) to nice +10 / Background QoS
Memory Pressure GC	Restarts bloated language servers when >500 MB sustained for 3+ checks
Crashpad Monitor	🆕 Monitors crash dumps — detects Extension Host instability before cascade crashes. No other extension does this.
Status Bar	$(eye) PANTHEON 4.8 GB — live RAM metrics + crash stability indicator
Command Palette	10 commands: Scan, Guard, Renice, Ka, Thoth, Metrics, Accountability, Crashpad, Settings
Thoth Context	Reads .thoth/memory.yaml for instant project context
Thoth Accountability	Cold-start benchmark proving 371K tokens saved per session

Install: Search "Pantheon" in extensions, or visit OpenVSX. Works in: VS Code, Antigravity, Cursor, Windsurf — any VS Code-based IDE. No AI required. No CLI binary dependency for core features.

---

🖥️ Menu Bar App — IDE-Independent Monitoring

Native macOS menu bar application that runs independently of any IDE.

Feature	Description
System Tray Icon	Heavyweight ankh (☥) in macOS menu bar — always visible
Live Stats	RAM pressure, Git status, branch, accelerator detection
Command Shortcuts	Quick-launch scan, guard, ghost hunt from the menu
Auto-Start	LaunchAgent with RunAtLoad: true, KeepAlive: true — survives reboots

Footprint: 4.5 MB on disk, ~50 MB RSS at runtime. macOS only (12.0+).

---

📄 License

MIT License — free and open source forever. See LICENSE.

---

🏢 Built by Sirsi Technologies

Sirsi Pantheon is built and maintained by Sirsi Technologies — the company behind the "Own Your Intelligence" platform for on-device AI infrastructure.

• Website: sirsi.ai
• GitHub: github.com/SirsiMaster
• Pantheon Hub: pantheon.sirsi.ai

𓃣 Documentation & Registry

• FAQ: Which Tool Should I Use?: Decision matrix for choosing the right Pantheon tool.
• Deity Registry: Interactive hub for all 12 deities.
• Build Log: Real-time chronicle of the Pantheon build.
• Case Studies: Origin stories and post-mortems.
• ADR Index: Every architectural decision record.
• OpenVSX Listing: VS Code extension on OpenVSX.

---

Built by Sirsi Technologies. Open source, MIT licensed.