pi-sonarqube

A Pi extension to run local SonarQube analysis and browse the resulting issues — all from within Pi.

Requirements

• Pi installed
• A running SonarQube server (e.g. http://localhost:9000)
• sonar-scanner available in $PATH

Install

pi install npm:@jonathan0823/pi-sonarqube

Or add it to your settings.json:

{
  "packages": ["npm:@jonathan0823/pi-sonarqube"]
}

Then /reload in Pi.

Quick start

1. Init project config

Inside a project directory, run:

/sonarqube init

For monorepos, you can add a user-defined alias and optional path:

/sonarqube init fe apps/web
/sonarqube init be apps/api

Pi will ask you for:

• SonarQube server URL (prefilled with http://localhost:9000)
• Project key (default: derived from directory name)
• Token (optional, used when your server requires auth)

The config is saved to <project>/.pi/sonarqube.json. Alias mappings live in the repo root .pi/sonarqube.workspaces.json.

2. Run analysis

/sonarqube analyze
/sonarqube analyze fe
/sonarqube analyze apps/web

Pi will:

1. Run sonar-scanner against your server
2. Wait for the analysis to complete
3. Fetch the latest issues
4. Return a concise summary

3. Browse issues

/sonarqube issues
/sonarqube issues fe

Use Up/Down to move, Enter to preview the affected source code, and Esc to close.

4. Open a specific issue

/sonarqube open 3
/sonarqube open fe 3

Commands

Command	Description
/sonarqube init [alias] [path]	Set up project config and optional alias
/sonarqube analyze [target]	Run analysis for an alias or path
/sonarqube issues [target]	Browse the latest analysis results for a target
/sonarqube open [target] <n>	Preview source at issue #n

Tool (for the LLM)

The extension also registers a sonarqube tool that the LLM can call with actions:

• analyze — run analysis
• issues — list issues
• open — open an issue with its index

Targets can be an alias like fe or a path like apps/web.

Configuration sources (precedence order)

1. Environment variables (highest)
   • SONARQUBE_URL / SONAR_HOST_URL
   • SONARQUBE_TOKEN / SONAR_TOKEN
   • SONAR_PROJECT_KEY
2. Project config — .pi/sonarqube.json (set via /sonarqube init)
3. Scan properties — sonar-project.properties
4. Defaults — http://localhost:9000, project key from directory slug

Project structure

packages/pi-sonarqube/
├── src/
│   └── index.ts          # Extension source + init command + config
├── dist/
│   ├── index.js          # Compiled output
│   ├── index.d.ts        # Type declarations
│   └── index.js.map      # Source map
├── fixtures/
│   ├── issue-project/    # Test project with known issues
│   └── clean-project/    # Test project with no issues
├── README.md
├── LICENSE
├── package.json
└── tsconfig.json

Contributing

See CONTRIBUTING.md.

License

MIT