Skip to main content

The quality gate for
AI-generated code

Linting, security, type checking, tests, and more. One command.

Install Now
View on GitHub
✓ 10 Quality Checks✓ Local-First✓ Open Source
lucidshark@terminal
$ ./lucidshark init
✓ Created lucidshark.yml
✓ Created .mcp.json
✓ Created .claude/skills/lucidshark/SKILL.md
✓ Modified .claude/CLAUDE.md
Claude> Run LucidShark scan
✓ Linting passed
✓ Formatting passed
✓ Type checking passed
✓ Security passed
✓ Tests passed
✓ Coverage 84%
✓ Duplication 2.1%
$ ./lucidshark overview --update
✓ Health Score: 9.1/10
✓ Generated QUALITY.md
$ _

Open Source • Local-First • Privacy-Focused • No Server Required

View on GitHub →

What LucidShark Does

10 Quality Domains in One Tool

Linting, formatting, type checking, SAST, SCA, IaC validation, container scanning, tests, coverage, and duplication analysis - all unified in a single command.

Local-First Privacy

Runs entirely on your machine. Zero cloud services, no SaaS subscriptions, no data collection. Your code never leaves your computer.

AI-Native Feedback Loop

Built for agentic engineering. Native Model Context Protocol integration lets AI agents receive structured feedback and fix issues automatically - write code, scan, fix, repeat.

Config as Code

Quality standards in lucidshark.yml, version controlled with your project for team-wide consistency.

CI/CD Ready

Same tool, same rules everywhere. Consistent results locally and in your pipeline.

Quality Dashboard

Generate QUALITY.md with health scores and trends, committed to git - no SaaS account required.

How It Works with Claude Code

Auto-Configure with AI

Running ./lucidshark init creates a ready-to-use lucidshark.yml and sets up the MCP integration. Optionally, ask Claude to autoconfigure for a tailored setup that analyzes your codebase.

1AI writes code
2LucidShark scans
3AI fixes issues
↻Repeat
# 1. Initialize (creates lucidshark.yml + MCP config)
$ ./lucidshark init
✓ Created lucidshark.yml
✓ Created MCP configuration

# 2. (Optional) Fine-tune config with AI
You: Autoconfigure LucidShark
Claude: Analyzing codebase...
✓ Updated lucidshark.yml

# 3. Use it
You: Run LucidShark scan
✓ All checks passed!

Language Support

Full Support

All 14 languages have dedicated tools for linting, formatting, type checking, testing, coverage, security, and duplication detection.

PythonTypeScriptJavaScriptJavaKotlinRustGoC#CC++ScalaSwiftRubyPHP

Need support for another language?

Request on GitHub →

Get Started

Download binary

$ curl -fsSL https://raw.githubusercontent.com/toniantunovi/lucidshark/main/install.sh | bash

For Linux/macOS. Installs locally - use ./lucidshark prefix for all commands.

Quick Start

  1. Initialize: Run ./lucidshark init and restart Claude Code
  2. Use it: Ask Claude “Run LucidShark scan” anytime
  3. Optional: Ask Claude “Autoconfigure LucidShark” to tailor the config to your project

Ship AI Code with Confidence

Join developers using LucidShark to catch issues before they reach production.

Get Started
Read Documentation

Free • Open Source • Local-First