LUCIDSHARK

> Unified code quality pipeline for AI-assisted development

LOCAL-FIRST OPEN SOURCE AI-NATIVE
lucidshark@terminal
$ lucidshark init
Created .mcp.json
Created .claude/CLAUDE.md
[INFO] Restart Claude Code to activate
Claude> Autoconfigure LucidShark
[AI] Analyzing codebase...
Generated lucidshark.yml
$ _

< FEATURES />

┌──────┐
│CLAUDE│
│ ◈◈◈◈ │
└──────┘

Claude Code Auto-Config

Just ask "Autoconfigure LucidShark"—Claude analyzes your codebase and generates perfect config automatically.

┌──────┐
│ MCP  │
│ ↔↔↔↔ │
└──────┘

MCP Integration

Native Model Context Protocol support. AI agents receive structured feedback and fix issues directly.

┌──────┐
│  9   │
│CHECKS│
└──────┘

9 Quality Domains

Linting, type checking, SAST, SCA, IaC validation, container scanning, tests, coverage, duplication.

┌──────┐
│ LOCAL│
│ ████ │
└──────┘

Local-First

Runs entirely on your machine. No cloud services, no SaaS subscriptions. Your code stays private.

┌──────┐
│ .yml │
│ ≡≡≡≡ │
└──────┘

Config as Code

Quality standards in lucidshark.yml. Version controlled with team-wide consistency.

┌──────┐
│ ↻↻↻↻ │
│ CI/CD│
└──────┘

CI/CD Ready

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

< CLAUDE CODE INTEGRATION />

Auto-Configure with AI

LucidShark integrates directly with Claude Code via MCP. Just ask Claude to configure your project—it analyzes your codebase, asks clarifying questions, and generates a tailored lucidshark.yml.

AI writes code
LucidShark checks
AI fixes issues
Repeat
01

INITIALIZE

$ lucidshark init
 Created .mcp.json
 Created .claude/CLAUDE.md
[INFO] Restart Claude Code to activate MCP
02

ASK CLAUDE

You: Autoconfigure LucidShark for this project

Claude: I'll analyze your codebase...
        Detected: Python, TypeScript
        Testing framework: pytest

        What coverage threshold do you want?
03

RESTART & USE

# Restart Claude Code to load the new config
# Then ask Claude to check your code:

You: Run LucidShark and fix any issues
 Scanning... All checks passed!

< SUPPORTED LANGUAGES />

FULL SUPPORT
Python TypeScript JavaScript Java Rust
PARTIAL
Kotlin
BASIC
Go Ruby C C++ C#
MINIMAL
PHP Swift Scala

< INSTALLATION />

pip (Python 3.10+)

$ pip install lucidshark

Standalone Binary (Linux/macOS)

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

Standalone Binary (Windows)

> irm https://raw.githubusercontent.com/toniantunovi/lucidshark/main/install.ps1 | iex

Quick Start with Claude Code

# 1. Initialize MCP integration
$ lucidshark init

# 2. Restart Claude Code, then ask:
You: Autoconfigure LucidShark for this project

# Claude analyzes your codebase and generates lucidshark.yml

# 3. Restart Claude Code again to load the new config

# 4. Now Claude can check your code quality:
You: Run LucidShark and fix any issues

READY TO SHIP BETTER CODE?

Join developers using LucidShark to maintain code quality with AI assistance.