Your AI.
Your rules.
Every tool.

One command gives every AI tool your architecture, rules, and style. 22 languages. Measurable improvement.

~/my-project
$ sigil init

Extracted: 31 entities, 28 components, 16 routes
Loaded: 4 directives (3 global, 1 project)
Created: CLAUDE.md, .cursorrules
Injected 4 directives

context.yaml 514 tokens
Health score: 94/100 (excellent)

Every AI tool now has your architecture + rules.
Impact

Measurable improvement.

Every metric quantified. Before Sigil vs. after — across speed, coverage, context quality, and automation.

Every model reaches
97/100
with Sigil context

Benchmarked across 4 AI models with 15 coding tasks each. Architecture-dependent tasks improve 17–23 points — from 74–80 to 96–97. 100% directive compliance. File summaries, entity maps, and stack detection eliminate guessing. Directives enforce your rules. Behavioral profiles shape how AI communicates. Sigil makes AI smarter.

Claude Sonnet
+23pts
74 → 97
Claude Haiku
+17pts
80 → 97
Gemini Flash
+18pts
79 → 97
DeepSeek
+22pts
74 → 96

Everyday Comprehension

Project overview
+50pts
50 → 100
Where to add code
+20pts
80 → 100
File purpose
+50pts
50 → 100
Dependencies
+17pts
83 → 100
Pattern recognition
+20pts
80 → 100
Zero Hallucinations 100%
97% accuracy with Sigil context — near-zero fabricated names, paths, or facts. Without Sigil: 74–80%.
Directive Compliance 100%
AI follows every rule you set. Error handling, type safety, credential management — all enforced automatically.

15 tasks per model · 4 models · 120 API calls · v1.1 optimized context
Run sigil benchmark on your own project to verify

The Difference

Before & After

What coding with AI looks like — without Sigil, and with it.

Without Sigil: The Fragmentation Tax

  1. Copy & paste files into the AI, hoping you picked the right ones
  2. Manually write "use TypeScript strict mode" and "run tests first" every session
  3. Switch to Cursor — none of your Claude rules carry over
  4. AI hallucinates function names, ignores your coding standards
  5. Different AI tools, different context, inconsistent output
Result: 6 config files. Zero consistency. Constant repetition.

With Sigil: One Pipe, Every Tool

  1. sigil init — one command extracts architecture, loads directives, configures every AI tool
  2. Your directives follow you everywhere — Claude, Cursor, Windsurf, Cline, Copilot, Continue
  3. AI understands every entity, route, pattern, AND your rules
  4. Token-optimized: critical rules always included, architecture pruned to fit
  5. One source of truth. Every tool. Every session.
Result: consistent AI behavior across every tool you use.
Capabilities

For everyone. Not just coders.

Core

Project Understanding

Sigil scans your project — any project, not just code — and builds a structured map of your files, directories, and content. Entities, components, routes, exports, patterns, and relations. AI stops guessing what you're working on and starts knowing.

22 Languages Any Project Type Sub-10s Extraction
sigil_impact

Impact Analysis

BFS blast radius: "what breaks if I change this?" Shows affected files, entities, components, routes within N hops.

sigil_dead_code

Dead Code Detection

Finds unreachable functions, unused exports, and fully removable files. Smart heuristics minimize false positives.

sigil_hotspots

Hotspot Ranking

Complexity × git churn = where bugs live. Ranks files by risk score. Data-backed refactoring priorities.

sigil graph

Interactive Graph

Zoom/pan, blast radius overlay, churn heatmap, animated particles, degree sizing, directory clustering, minimap.

sigil_health

Health Checks

10 architectural checks: circular deps, god components, auth gaps, dead functions, config drift. Score 0–100.

Rules Engine

Directive Enforcement

Define rules with priority markers. Hooks inject them every prompt and block violations in real-time. AI can't miss what's mandatory.

Personality

Behavioral Profiles

Define how AI communicates — concise or detailed, formal or casual, your workflow rules. AI adapts to YOU.

sigil init

Multi-Tool Support

One command configures Claude Code, Cursor, Windsurf, Cline, Copilot, and Continue simultaneously.

sigil context

Token-Optimized

v1.1 format: 53% smaller. Library noise filtered, exports grouped, analysis data stripped. More signal per token.

10 tools

MCP Server

AI queries architecture, health, impact, dead code, hotspots in real-time. Always fresh, sub-100ms cached.

sigil_switch

Multi-Project

Switch between projects without restarting. Context, directives, and history follow you across repos.

Session Memory

AI remembers across sessions. Auto-journals commits, active focus detects from your branch.

File Summaries

One-line role per file. AI understands purpose before reading. +50pt accuracy boost on file purpose tasks.

Not a developer? Use the web app →

How It Works

Four steps. Any project.

1

Sigil reads your project

It scans your files and folders — code, documents, configs, anything — and builds a structured understanding of what you’re working on. Like giving AI a map instead of making it wander blind.

2

You set the rules

Tell AI how you want it to behave. “Be concise.” “Always cite sources.” “Never change my writing style.” These rules are enforced automatically on every interaction — AI can’t ignore them.

3

AI gets smarter — instantly

Sigil feeds your project context and rules into your AI tools automatically. No copy-pasting. No repeating yourself. AI understands your project structure, follows your rules, and gives you better answers — every time.

4

It works everywhere

Claude, Cursor, Copilot, Windsurf, Cline, Continue — Sigil configures all of them from one source. Switch tools without losing your context or your rules. One setup, every AI tool.

For Developers

31 commands. Full cycle.

Define directives, extract architecture, visualize it, query it, analyze impact, find dead code, rank hotspots, track drift, check health — all from the terminal.

Directives

Define AI rules with priority, category, and conditions. Global directives cascade into every project. Project directives override globals.

$ sigil directives add "Never use any" --priority high
$ sigil directives add "Use pytest" --when-language python
$ sigil directives

1. [G] [critical] (security) Never hardcode credentials
2. [G] [high] (code) Never use any

Init

Extracts architecture, loads directives, detects installed AI tools, and configures all of them in one command.

$ sigil init

✓ Extracted: 31 entities, 28 components, 20 routes
✓ Loaded 4 directives (3 global, 1 project)
✓ Created CLAUDE.md, .cursorrules
✓ Injected 4 directives

Extract

Scan your project into a structured context.yaml. Works on any project — code, docs, research, design. Code projects get deep analysis across 22 languages.

$ sigil extract

✓ Extracted: 31 entities, 28 components
20 routes, 384 exports (2491ms)
📄 Saved to: context.yaml

Show

Display a formatted architecture summary in the terminal. Entities, components, routes, patterns — at a glance.

$ sigil show

my-app — Context Summary
Stack: next.js, typescript, drizzle
Entities: 31 | Components: 28

Graph

Interactive architecture visualization. Zoom/pan, impact blast radius, git churn heatmap, edge particles, directory clustering, minimap.

$ sigil graph

⚡ Sigil Graph v2 — my-app
🌐 http://localhost:4040
Nodes: 465 | Edges: 597 | Churn: 250

Describe

Describe any entity, component, or export. Shows fields, relations, props, hooks, and source location.

$ sigil describe Users

Entity: Users
Fields: id, email, name, createdAt
Relations: Posts (1:many), Comments

Diff

Detect architectural drift. See what changed structurally — added entities, modified props, removed routes.

$ sigil diff

+ entity: PaymentMethod (5 fields)
~ component: Dashboard
  + prop: billingEnabled: boolean
- route: /api/legacy-auth

Query

Ask questions about your architecture. Dependency trees, reverse deps, import chains, dead function detection.

$ sigil query "what depends on User"

8 dependent(s) of "User":
[component] UserCard imports User
[import] routes/api → schema {User}
...6 more

Health

10 architectural checks. Circular deps, god components, auth gaps, dead functions, config drift. Score 0–100.

$ sigil health

Score: 87/100 (good)
✗ Circular dep: auth → session → auth
⚠ 3 dead functions detected
⚠ 2 env vars missing from .env

Context

Token-optimized output for AI prompts. Critical directives always included, architecture pruned to fit your budget.

$ sigil context --tokens 4000

# my-app — Architecture
Entities (31) · Routes (20) · Directives (4)
~574 tokens.

Watch

Auto re-extract on file changes. Context stays fresh without manual re-runs. 1.5s debounce, sub-100ms when cached.

$ sigil watch

⚡ Sigil Watch
✓ Extracted: 31 entities (1720ms)
👁 Watching: src, app, lib
↻ src/index.ts changed (90ms)

Impact

Blast radius analysis. See what breaks before you change it — files, entities, components, routes affected within N hops.

$ sigil impact Users

Impact Analysis — Users
Resolved as: entity | Depth: 3
50 files affected
Entities: 3 | Components: 3

Dead Code

Find unreachable functions, unused exports, and fully removable files. Estimates lines saved.

$ sigil dead-code

1 dead fn | 245 unused exports
~1240 lines removable
79 files may be removable

Hotspots

Complexity × churn = where bugs live. Ranks files by risk with visual bars. Find refactoring priorities.

$ sigil hotspots

#1 100% init.ts
#2 87% health.ts
████████████████████

Doctor

Scan all registered projects at once. Extract, health check, auto-fix — one command heals everything.

$ sigil doctor

Scanning 8 projects...
✓ my-app: 92/100
⚠ api-service: 71/100 (2 issues)

Fix

Auto-fix detectable issues. Missing error boundaries, env config drift, stale exports — fixed in place.

$ sigil fix

✓ Added error.tsx boundary
✓ Synced .env.example
2 fixes applied

Snapshot

Generate a shareable HTML architecture report. Drop it in a PR, Slack, or wiki — zero dependencies.

$ sigil snapshot

✓ Generated sigil-snapshot.html
31 entities, 28 components, 20 routes

Profile

Define how AI should work with you — communication style, workflow rules, standards. Injected into every project.

$ sigil profile edit

name: Rio
style: concise
on_error: stop after 2 failures

Projects

List and manage all Sigil-tracked projects. See health, staleness, and stack at a glance.

$ sigil projects

my-app next.js · 92/100 · fresh
api express · 71/100 · stale
cli typescript · 88/100 · fresh

Rules

Legacy rules from sigil.config.yaml. Simpler than directives — plain text rules injected into AI configs.

$ sigil rules

1. Use conventional commits
2. Run tests before committing

Hooks

Install directive enforcement hooks for all detected AI tools at once.

$ sigil hooks install

✓ Claude Code: enforcer + blocker
✓ Pre-commit: auto-extract

Hook

Install a hook for a single AI tool. Fine-grained control over which tools get enforcement.

$ sigil hook install claude

✓ Claude Code hooks installed

Unhook

Remove enforcement hooks from a specific AI tool.

$ sigil unhook claude

✓ Claude Code hooks removed

Activate

Activate Sigil Pro with a license key. Unlocks health checks, doctor, watch, MCP, and unlimited directives.

$ sigil activate XXXX-XXXX

✓ Pro activated

Status

Check your current license status, plan tier, and expiration date.

$ sigil status

Plan: Pro | Expires: 2027-01-01
Features: all unlocked

SEO

Generate SEO-optimized meta content from your architecture. Descriptions, keywords, structured data.

$ sigil seo

title: my-app — 31 entities, 20 API routes
keywords: drizzle, next.js, postgresql

Metrics

View AI performance metrics. Directive compliance rate, violations blocked, per-project breakdown. Collected passively by hooks.

$ sigil metrics

Compliance: 94.2%
147 sessions | 2 violations blocked

Benchmark

A/B test AI performance with vs without Sigil context. 10 tasks, graded on hallucination, correctness, and directive compliance.

$ sigil benchmark

With Sigil: 87/100
Without: 52/100
Improvement: +35 points
What Your AI Gets

Architecture + directives. One payload.

Run sigil context --tokens 4000 — your AI receives a unified, token-optimized context with architecture and your directives baked in.

sigil context --tokens 4000
$ sigil context --tokens 4000

  # my-app — Architecture Context

  ## Stack
  framework: next.js@16 · orm: drizzle · database: postgresql

  ## Directives (2)
  - Never hardcode credentials [critical]
  - Always use TypeScript strict mode [high]

  ## Entities (31)
  - Users [src/db/schema.ts]: id, email, name, role
  - Posts [src/db/schema.ts]: id, title, content, authorId
  ...29 more

  ## Routes (20)
  - /api/users GET, POST(auth) [src/app/api/users/route.ts]
  - /api/posts GET, POST(auth), DELETE(auth)
  ...18 more

  ## Directives (1)
  - Use server components by default

  ~574 tokens.
AI Integration

MCP Server — zero-friction context.

Add one line to your AI tool config. Sigil provides architecture + directives for all 22 languages on every session — no manual steps, always fresh, sub-100ms cached.

// Requires Pro license — get your key at sigil.riomyers.com
"mcpServers": {
  "sigil": { "command": "sigil-mcp-server" }
}
sigil://context resource

Instant Context

AI reads architecture + directives on session start in <100ms. Entities, routes, patterns, and your rules — everything, instantly.

watch mode

Always Fresh

File watcher auto-updates context when you save. Your AI never works with stale architecture.

sigil_query tool

Rich Queries

AI can query dependency trees, import chains, dead functions, reverse deps — "what depends on User", "show import graph", "find dead code."

sigil_health tool

Health Checks

10 architectural checks: circular deps, god components, auth gaps, dead functions, config drift. Score 0–100 with actionable suggestions.

sigil_impact tool

Blast Radius

AI asks "what breaks if I change this?" before refactoring. BFS traversal across import, call, and component graphs. Shows affected files, entities, routes by depth.

sigil_dead_code tool

Dead Code

AI finds unreachable functions and unused exports across the codebase. Groups by file, estimates lines removable, identifies fully dead files.

sigil_hotspots tool

Risk Hotspots

AI identifies the highest-risk files by churn × complexity. Prioritizes refactoring targets where bugs are most likely to occur.

New

Built-in AI Chat.

Talk to AI that already knows your project. No API keys. No setup. Context-aware from the first message.

my-project
Claude Sonnet
YOU
How should I restructure the auth middleware to support role-based access?
SIGIL
Based on your architecture, the auth flow passes through src/middleware/auth.tssrc/lib/session.ts. Your Users entity already has a role field. I'd recommend a guard pattern with…
Context
Project architecture loaded as system prompt
Stream
SSE streaming with live markdown rendering
History
Conversations persist across sessions
Free
50 messages/day, no credit card
Try Sigil Chat →
Visualization

Interactive architecture graph.

Zoom, pan, click for impact blast radius, toggle git churn heatmap, filter by type. Animated edge particles, degree-based sizing, directory clustering, minimap. Auto-shuts down when you close the tab.

Sigil Graph — architecture visualization

Open live demo →  ·  Cal.com: 1,072 components · 67 routes · 1,676 exports · parsed in 5.8s

Use Cases

When to use Sigil

Real scenarios where structured context changes everything.

sigil directives

Rules That Follow You

Define "never hardcode secrets" once. It applies everywhere — Claude Code, Cursor, Windsurf, Cline, Copilot, Continue. Global directives cascade into every project. Project directives override when needed.

sigil context --tokens 4000

Token-Aware Context

Large codebase? Sigil prunes intelligently. Critical directives always included. Architecture fills the remaining budget. Your AI gets the maximum context that fits — not a raw dump that overflows.

sigil health + sigil query

Find Dead Code & Config Drift

Sigil detects unreferenced functions, imported-but-never-called symbols, and env vars that are defined but unused (or used but undefined). Deep static analysis, no runtime needed.

sigil graph

Onboard in 15 Minutes

New to a project with hundreds of files? Launch the interactive graph. Click through components, trace dependencies, understand the architecture visually — without reading a single line of code.

Comparison

Why Sigil?

Existing tools solve pieces of the puzzle. Sigil is the complete picture.

Feature Sigil repomix aider repo-map Cursor Indexing
Structured output YAML/JSON flat text ~ tree-sitter map proprietary
Architecture-aware entities, routes, patterns, call graphs file dump ~ symbols only ~ basic
AI Directives priority, conditional, inherited ~ .cursorrules only
Token-optimized budget-aware pruning
Interactive graph force-directed
Drift detection structural diff
Auto-configures AI tools 10 tools self only
Behavioral profiles global + local
MCP server (auto-context) resource + tools
Global + project rules directives with inheritance
Plugin system any language
Free tier available Free + Pro

AI Directives with Inheritance

Define rules globally, override per-project. Priority-based pruning under token pressure. Conditional by language/framework.

No other tool offers structured, portable AI directives.

Token-Optimized Unified Context

Architecture + directives in one budget-aware payload. Critical rules never pruned.

Structured YAML/JSON Output

Not a flat text dump — structured architecture with entities, components, routes, and relationships.

repomix: flat text · aider: tree-sitter map · Cursor: proprietary

Interactive Dependency Graph

Force-directed visualization of your entire codebase. Click, search, filter by type.

No other tool offers this.

Architectural Drift Detection

Compare snapshots to see what changed structurally — added entities, modified props, removed routes.

Auto-Configures 6 AI Tools

Claude Code, Cursor, Windsurf, Cline, Copilot, Continue — one command configures all.

MCP Server — Zero-Friction AI Context

One config line. AI gets full architecture on every session. Auto-updates on file changes.

Behavioral Profiles

Define your identity, style, and workflow rules globally. Every project, every AI tool.

22 Languages Built-In

TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, PHP, C#, Ruby, Swift, Elixir, Dart, C/C++, Scala, Lua, Zig, Haskell, OCaml, Perl, R, Shell — all with lazy loading. Extend via plugins.

Free Tier + Pro Plans

Get started free. Upgrade for health checks, auto-fix, watch mode, and unlimited directives.

Pricing

Choose your plan.

Start free. Scale as you grow. Every plan makes your AI dramatically better.

Free
$0
forever
✓ Extract architecture
✓ 5 directives
✓ 3 presets
✓ Context output
✓ Show + diff
✗ Health checks
✗ Auto-fix
✗ Watch mode
✗ MCP server
Get Started
MOST POPULAR
Pro
$8
per month
✓ Everything in Free
Unlimited directives
All 10 presets
Health checks + scoring
sigil fix (auto-repair)
Watch mode
MCP server
Project registry + audit
sigil doctor (batch heal)
Smart context (activity, health)
Get Pro
Team
$19
per seat / month
✓ Everything in Pro
Shared team directives
Org-wide behavioral profiles
CI/CD integration
Audit dashboard
Priority support
Custom presets
SSO (coming soon)
 
Get Team

After purchase

You'll receive a license key by email. Activate it once — works on all your machines:

$ sigil activate sigil_pro_your_key_here

Key stored at ~/.sigil/license.key. Or set SIGIL_LICENSE_KEY env var for CI/CD.

Get Started

1 curl -fsSL sigil.riomyers.com/install | sh one-line install, auto-updates
2 sigil directives add "Never hardcode credentials" --priority critical Define your AI rules (global, once)
3 sigil init Extract architecture + load directives + configure all AI tools
4 Every AI tool now has architecture + your directives. Token-optimized.

Not a developer? Try the web app →

What's New

Recent Updates

Latest improvements to Sigil.

NEW
sigil doctor — batch heal all projects in one sweep
Extract, diagnose, auto-fix, re-verify across every registered project. Global auth detection, issue suppression, safety warnings.
PERF
OOM fix — 17x memory reduction on large monorepos
Excluded .d.ts files from ts-morph glob. 4GB crash down to 229MB, clean 2s extraction.
NEW
Universal presets — writer, researcher, business, student, creative modes
Sigil now supports non-coding workflows with 5 new directive presets
NEW
Stats dashboard — AI improvement benchmarked across 5 models
Every metric measured: 22x faster caching, 22 languages, unlimited directives
PERF
22x faster cached extraction — 2000ms down to 90ms
mtime fast-path, hash deduplication, lazy plugin loading
NEW
Smart context — recent activity, health snapshot, critical files
AI gets git history, health score, and hub files alongside architecture
NEW
sigil fix — auto-repair issues found by health checks
Generates error boundaries, syncs env vars, reports unfixable issues
NEW
Project audit dashboard — health scores for every project at a glance
Run sigil init from any directory to audit all detected projects
NEW
MCP polyglot — all 22 languages now supported via MCP server
Python, Go, Rust, Java, and 8 more languages via lazy loading
NEW
Deep Python parsing — entities, imports, env vars, function analysis
Pydantic models, dataclasses, FastAPI routes, import graph extraction
FAQ

Frequently Asked Questions

What is Sigil?

Sigil gives AI real context about your projects — files, structure, rules, and how you work. It works for any project: code, documentation, research, design, business operations. For code projects, it adds deep architecture intelligence: entities, components, routes, call graphs, impact analysis, dead code detection, and more. It auto-configures Claude, Cursor, Windsurf, Cline, Copilot, and Continue with your context. Your AI tools go from guessing to knowing.

What languages does Sigil support?

22 languages: TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, PHP, C#, Ruby, Swift, Elixir, Dart, C/C++, Scala, Lua, Zig, Haskell, OCaml, Perl, R, and Shell/Bash. Each has a dedicated parser that extracts language-specific constructs (React components, Drizzle entities, FastAPI routes, etc.).

How is Sigil different from Cursor rules or .cursorrules?

Cursor rules are static text you write manually. Sigil automatically extracts your architecture, detects your stack, and generates optimized context for every AI tool — not just Cursor. One sigil init configures Claude Code, Cursor, Windsurf, Cline, Copilot, and Continue simultaneously.

What does sigil doctor do?

sigil doctor scans all your registered projects in one sweep: extracts fresh context, runs health analysis (circular deps, god components, auth gaps, dead code), auto-fixes what it can (error boundaries, env config), and shows you what needs manual attention. One command, all projects healed.

Is Sigil free?

Yes. The free tier includes architecture extraction, context output, show, diff, and up to 5 directives. Pro ($8/mo) adds health checks, sigil doctor, auto-fix, watch mode, MCP server, unlimited directives, and the project audit dashboard.

How do I activate my Pro license?

After purchasing, you'll receive a license key by email. Run sigil activate your_key in your terminal. The key is stored at ~/.sigil/license.key and works across all your machines. You can also set the SIGIL_LICENSE_KEY environment variable for CI/CD.

Does Sigil send my code to any server?

No. Sigil runs 100% locally. Your code never leaves your machine. The extracted context stays in your project directory as context.yaml. There is no cloud dependency, no telemetry, no data collection.