Project intelligence
for AI coding tools.

26 facade tools route to 170+ handlers under the hood. A small tool surface keeps token usage low while giving your agent full access to issues, ADRs, experiments, and context — so it can plan, execute, and stay consistent.

Get Started Browse Tools

26 facade tools170+ handlers across 20 domains

Tested with Claude Desktop, Claude Code, Cursor, and VS Code

...GitHub VS Code

What it enables

Turn your codebase into structured project intelligence that your AI tools can query and update.

Track

Capture work as structured artifacts. Issues, epics, and friction logs stored in your repo alongside code.

> "Create an epic for auth and
  spawn three issues for it"

Decide

Record architecture decisions with ADRs and policies. Your AI assistants reference decisions linked to real files and commits.

> "Record an ADR: we chose JWT
  over sessions for auth"

Evolve

Agents can propose new features through proposals. When an agent hits a gap, it can request the capability and scaffold an experiment to test it.

> "Propose auto-generating changelogs
  from commits and scaffold
  an experiment for it"

Quick Start

Connect in 2 minutes. Install and add the config to your AI client.

Install

npm install -g @decibelsystems/tools

Or run directly with npx:npx @decibelsystems/tools

01 Cursor

Add to ~/.cursor/mcp.json:

json{
  "mcpServers": {
    "decibel-tools": {
      "command": "npx",
      "args": ["-y", "@decibelsystems/tools"]
    }
  }
}

02 Claude Code

Install as plugin (recommended):

/plugin marketplace add
  decibelsystems/decibel-tools-mcp

/plugin install
  decibel-tools@decibel-marketplace

03 Claude Desktop

Add to claude_desktop_config.json:

json{
  "mcpServers": {
    "decibel-tools": {
      "command": "npx",
      "args": ["-y", "@decibelsystems/tools"]
    }
  }
}

04 VS Code

Install from the marketplace:

ext install decibel-systems.decibel-tools

How it works

Local-first. Committed to git. Forkable. Works offline.

Your repo

.decibel/

MCP server

AI client

Decibel Tools creates a .decibel/ folder in your project. Every artifact (issues, ADRs, experiments, learnings) is committed as YAML alongside your code. The MCP server exposes them to your AI tools.

your-project/
└── .decibel/
    ├── sentinel/
    │   ├── issues/      # ISS-0001.yml
    │   └── epics/       # EPIC-0001.yml
    ├── architect/
    │   ├── adrs/        # ADR-0001.yml
    │   └── policies/    # POL-0001.yaml
    ├── dojo/
    │   ├── proposals/   # DOJO-PROP-0001.yml
    │   └── experiments/ # DOJO-EXP-0001/
    ├── designer/        # Design decisions
    ├── friction/        # Pain point logs
    ├── learnings/       # Knowledge docs
    ├── context/         # Pinned facts
    └── voice/inbox/     # Voice messages

Workflows

Just talk to your AI assistant. Tools route automatically.

Initialize & plan

1project_init creates .decibel/
2sentinel_log_epic creates EPIC-0001
3sentinel_createIssue spawns linked issues

"Initialize decibel for this project and create an epic for user authentication with three issues."

Decide & record

1architect_createAdr records the decision
2architect_createPolicy adds guardrails
3designer_record_design_decision captures UX rationale

"Record an ADR: we chose JWT over sessions, and add a policy that all auth endpoints must validate tokens."

Propose & experiment

1dojo_create_proposal scopes the idea
2dojo_run_experiment tests in sandbox
3dojo_graduate_experiment promotes to production

"Propose auto-generating changelogs from commits. Scaffold an experiment to test it."

See it in action

Voice capture from the mobile app becomes structured artifacts in your repo.

Voice memo on a walk → auto-routed to issues, proposals, friction logs. Oracle surfaces health, roadmap, and priorities.

Domains

108 tools across 14 domains

Each domain manages a specific aspect of your project. All data stored in .decibel/ inside your repo.

Sentinel

16 tools

Issues, epics, test specs, scanning

Dojo

10 tools

Proposals, experiments, incubation

Architect

6 tools

ADRs, policies, oversight

Roadmap

6 tools

Strategy, milestones, health

Oracle

2 tools

Next actions, roadmap evaluation

Designer

7 tools

Design decisions, crits, tokens, principles

Friction

4 tools

Pain points, signal tracking

Learnings

2 tools

Living knowledge documents

Context

8 tools

Pinned facts, events, artifacts

Registry

7 tools

Project discovery, init, aliases

Agentic

4 tools

Config compilation, rendering

Provenance

1 tools

Audit trail

Status

Shipped

Claude Desktop & Claude Code plugins (MCP)
Cursor integration
VS Code extension
npm package published
Repo scanning & project health checks
Design/architecture memory stored alongside code
Structured issue generation and refactor proposals

In Active Development

ChatGPT plugin (SSE endpoint)
Replit integration
Runs & forensics (prompt capture → events → summary → drift/learned notes)
Playbooks: repeatable agent workflows with typed artifact outputs
Daemon runtime (built, in testing)

Early Exploration

Mobile app with voice capture → tool routing
Voice memos become issues, proposals, friction logs
Oracle in mobile app (health, roadmap, priorities)
Domain-scoped agents with explicit jurisdictions and autonomy levels
Tools Pro: team sync, dashboards, higher automation (account/subscription required)

Who it's for

Solo builders who've outgrown their first AI-powered prototypes.

Small teams with a real product and a codebase that's getting away from them.

Technical founders who want AI to help, not silently undermine their architecture.

If you're already shipping with AI and feel the entropy building up, you're the audience.

Let's start with your current stack.

We're inviting a small number of teams into a hands-on private preview. You bring your repo and your reality. We bring Decibel Tools and help wire it up.

Get in Touch GitHub

Drop an email, DM, or whatever channel you found us through, and we'll talk scope, fit, and next steps.

Project intelligencefor AI coding tools.