# codescene-codehealth

Inspects codebase health on a 1.0 to 10.0 scale, flags code smells, and catches technical debt regressions before commits inside Claude Code.

- plugin · `type=plugin` · Claude Code · ★ 72
- Author: codescene-oss
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codescene-oss/codescene-mcp-server/tree/HEAD/claude-code-plugin
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/plugins/codescene-codehealth

## What it does

This plugin connects Claude Code to the CodeScene MCP server. It scores file quality from 1.0 to 10.0, points out code smells, and inspects staged changes prior to commit. For pull requests, it evaluates branch diffs to spot deteriorating patterns early.

The tools run in standalone mode or hook directly into CodeScene Cloud and on-premise setups. A server connection reveals project hotspots and developer ownership maps for routing reviews. Authentication works through browser-based OAuth or personal access tokens.

Local `Node.js` is required so `npx` can launch the MCP server binary. Keep in mind that an active personal access token in your configuration disables OAuth until you remove that PAT.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install codescene-codehealth@claude-community
```

## When to use it
- prevent code quality regressions in staged files prior to committing
- measure a file's numeric Code Health score from 1.0 to 10.0
- map project-level hotspots and targets for refactoring
- discover file owners to route code reviews effectively

## Example prompts
- Check my staged files for quality regressions using `/codescene:safeguarding-ai-generated-code`
- Calculate the Code Health score for `src/index.ts` and explain the findings
- Identify the primary technical debt hotspots with `/codescene:prioritizing-technical-debt`

## Similar
- [refactor](https://affpapa.org/en/nevibecode/skills/refactor-2.md) — skill · ★ 45376
- [Technical Debt Remediation Plan](https://affpapa.org/en/nevibecode/agents/technical-debt-remediation-plan.md) — subagent · ★ 40451
- [remove-technical-debt](https://affpapa.org/en/nevibecode/skills/remove-technical-debt.md) — skill · 2300 installs
- [refactor-legacy-code](https://affpapa.org/en/nevibecode/skills/refactor-legacy-code.md) — skill · 603 installs
- [tech-debt](https://affpapa.org/en/nevibecode/commands/tech-debt.md) — command · ★ 41823
- [tech-debt-tracker](https://affpapa.org/en/nevibecode/skills/tech-debt-tracker.md) — skill · 614 installs

From the same set: [codescene-oss/codescene-mcp-server](https://affpapa.org/en/nevibecode/by/codescene-oss/codescene-mcp-server.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md