Metadata-Version: 2.5
Name: nablr
Version: 4.9.0
Summary: nablr — AI-powered SDLC governance. 19 expert personas enforcing quality gates via Model Context Protocol (MCP).
Project-URL: Homepage, https://nablr.dev
Project-URL: Repository, https://github.com/nablrco/nablr
Project-URL: Bug Tracker, https://github.com/nablrco/nablr/issues
Author-email: Mishtert T <Mishtert.Thangaraj@myridius.com>
License: Proprietary
License-File: LICENSE
Keywords: agents,ai,code-quality,governance,mcp,relay-engineering,sdlc
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.12
Requires-Dist: fastmcp<4.0.0,>=3.4.2
Requires-Dist: mcp>=1.25.0
Requires-Dist: networkx>=3.4
Requires-Dist: pydantic>=2.12.5
Requires-Dist: structlog>=25.5.0
Requires-Dist: tree-sitter-markdown>=0.3.0
Requires-Dist: tree-sitter-python>=0.21.0
Requires-Dist: tree-sitter-typescript>=0.21.0
Requires-Dist: tree-sitter>=0.21.0
Requires-Dist: watchdog>=4.0.0
Description-Content-Type: text/markdown

# nablr

![Security Scan](https://github.com/nablrco/nablr/actions/workflows/security-scan.yml/badge.svg)
![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)
![PyPI](https://img.shields.io/pypi/v/nablr)

<!-- STORY-DOCS-CLAIMS-001 FR-10: Python badge floor corrected to match
pyproject.toml's requires-python. FR-1/FR-2: persona and scanner counts
below corrected to match AVAILABLE_AGENTS/ScanTargetAction's real sizes. -->

**AI-powered SDLC governance via Model Context Protocol.**

**nablr** *(pronounced like "enabler")* connects to your AI assistant (Cursor, Claude Desktop, Windsurf) and enforces quality gates across your entire software delivery lifecycle — 18 expert personas, 12 built-in scanners, full workflow orchestration.

> Documentation: [docs.nablr.dev](https://docs.nablr.dev)

---

## Why nablr

AI assistants accelerate typing, not engineering.

| What they promised | What actually happens |
|--------------------|----------------------|
| Ship faster | More code, same bugs |
| Higher quality | AI-generated tech debt |
| Reduce costs | Increased rework cycles |

nablr is the orchestration layer that fixes this: quality enforcement, workflow context, and persistent state injected directly into your AI assistant via MCP.

---

## Free vs paid

| Capability | Free | Pro |
|-----------|------|-----|
| 12 built-in scanners | ✅ | ✅ |
| Workflow orchestration | ✅ | ✅ |
| Codebase mapping | ✅ | ✅ |
| Persona prompts | 2 (`discovery`, `platform_engineer`) | 18 (all) |
| Rule files + language/framework configs | Ships in every install, read from disk | Ships in every install, plus server-fetched freshness |
| 14-day trial (full Pro) | ✅ | — |

---

## Installation

Requires [`uv`](https://docs.astral.sh/uv/getting-started/installation/).

Add to your AI assistant config:

```json
{
  "mcpServers": {
    "nablr": {
      "command": "uvx",
      "args": ["nablr"]
    }
  }
}
```

Config file locations:
- **Cursor**: `~/.cursor/mcp.json`
- **Claude Desktop** (macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windsurf**: `~/.codeium/windsurf/mcp_config.json`

Restart your AI assistant after saving. Full setup guide at [docs.nablr.dev/quickstart](https://docs.nablr.dev/quickstart).

---

## Quick start

```
# Entry point — loads nablr context into your AI assistant
activate nablr

# Start a 14-day free trial (no credit card)
Start my nablr trial

# Invoke a persona
Set agent to developer

# Run a scanner
Scan this directory for technical debt

# Full SDLC workflow
Set agent to discovery  →  Set agent to architect  →  Set agent to developer
```

---

## Personas

18 expert agents covering every SDLC phase: Discovery, Product Manager, QA Lead, Specifier, Architect, Developer, Tester, Test Designer, PR Reviewer, Scrum Master, Security Owner, Forensic Engineer, Strategist, Platform Engineer, Impact Architect, Migration Planner, Parity Tester, Cutover Engineer.

`discovery` and `platform_engineer` are permanently free.

---

## Security

nablr makes exactly one category of outbound call: license validation to `nablr-api.nablrco.workers.dev:443`. Your code never leaves your machine.

Paid assets are pre-cached to `~/.nablr_cache/assets/` on activation — all subsequent prompt generation works fully offline.

```bash
# Verify no unexpected network calls
uv run python scripts/airgap_proof.py
```

Full security details at [docs.nablr.dev/security](https://docs.nablr.dev/security).

---

## License

Proprietary. All rights reserved. © nablr
