by toniantunovi
Ship AI-generated code without the fear
# Add to your Claude Code skills
git clone https://github.com/toniantunovi/lucidsharkAI writes code → LucidShark checks → AI fixes → repeat
<p align="center">
<img src="docs/lucidshark-terminal.gif" alt="LucidShark Demo" width="1000">
</p>
Local-first - No server, no SaaS account. Runs on your machine and in CI with the same results.
Configuration-as-code - lucidshark.yml lives in your repo. Same rules for everyone, changes go through code review.
AI-native - MCP integration with Claude Code. Structured feedback that AI agents can act on directly.
Unified pipeline - Linting, type checking, formatting, security (SAST/SCA/IaC), tests, coverage, and duplication detection in one tool. Stop configuring 5+ separate tools.
Open source & extensible - Apache 2.0 licensed. Add your own tools via the plugin system.
# 1. Install LucidShark (choose one)
# Option A: pip (requires Python 3.10+)
pip install lucidshark
lucidshark init # Configure Claude Code
# Option B: Standalone binary (no Python required)
curl -fsSL https://raw.githubusercontent.com/toniantunovi/lucidshark/main/install.sh | bash
./lucidshark init # Configure Claude Code (note the ./ prefix)
# 3. Restart your AI tool, then ask it:
# "Autoconfigure LucidShark for this project"
No comments yet. Be the first to share your thoughts!
That's it! Your AI assistant will analyze your codebase, ask you a few questions, and generate the lucidshark.yml configuration.
| Method | Command | Usage | Notes |
|--------|---------|-------|-------|
| pip | pip install lucidshark | lucidshark | Requires Python 3.10+, installed to PATH |
| Binary (Linux/macOS) | curl -fsSL .../install.sh \| bash | ./lucidshark | No Python required, installs to current directory |
| Manual | Download from Releases | ./lucidshark | Pre-built binaries |
Important: Binary installations create a project-local ./lucidshark file. Use ./lucidshark (not lucidshark) to ensure you're running the project-specific version.
Pip install: Use lucidshark
lucidshark scan --all # Run all quality checks
lucidshark scan --linting # Run specific domains
lucidshark scan --linting --fix # Auto-fix linting issues
lucidshark scan --all --dry-run # P...