🧠 Open-Source · CLI · AI-Powered

Your intelligent code assistant for devs who ship in silence.

Appaveli CodeMind is an open-source AI-powered CLI for rapid, intelligent code analysis, refactoring, security scanning, and test generation across your real-world stack.

View on GitHub Install via pipx

Supports: Java · Kotlin · Swift · C++ · Dart · PHP · JavaScript

CLI Snapshot appaveli-codemind 

# Analyze a file with full report
appaveli-codemind analyze -f src/UserController.php

# Just show the summary
appaveli-codemind analyze -f src/UserController.php --summary

# Export pretty HTML or Markdown report
appaveli-codemind analyze -f src/UserController.php --report html
appaveli-codemind analyze -f src/UserController.php --report markdown

🚀 Core Features

Built for engineers who want real leverage: smarter analysis, faster refactors, and better security — all from your terminal.

🔍
Code Analysis

Detect language, metrics, and potential issues across supported files in your project.

Export rich Markdown or HTML reports for deeper review and documentation.

🔐
Security Scanning

Run project-wide security scans to surface risky patterns and vulnerabilities.

Get issue types, severity levels, and fix suggestions you can act on immediately.

🧪
Test Generation

Generate unit and integration tests with LLM help for your existing code.

Use your ecosystem’s testing frameworks — JUnit, XCTest, Jest, PHPUnit, and more.

🔁
AI Refactoring

Clean up legacy code with AI-powered refactors and style improvements.

Pick refactor types like general cleanup, naming improvements, or performance optimization.

🏗️
Boilerplate Generator

Generate data classes, controllers, services, and domain models for your stack.

Supports Laravel, Spring, SwiftUI, Compose, Flutter, React, and more via boilerplate templates.

🧠
Multi-language Support

Java · Kotlin · Swift · C++ · Dart · PHP · JavaScript.

Language-aware detection and prompts, designed to feel native in each ecosystem.

CodeMind Web Playground Beta

Prefer a UI? Run code analysis, security scans, and AI-powered refactors directly in your browser.
The CLI offers full power — but this playground is perfect for quick checks and demos.

🚀 Launch Web App

No installation required · Runs on Appaveli CodeMind API

🛠️ Example Usage

Core workflows you can run from day one — no extra wiring required.

Analysis & Reports

# Analyze a file with full report
appaveli-codemind analyze -f src/UserController.php

# Just show the summary
appaveli-codemind analyze -f src/UserController.php --summary

# Export pretty HTML or Markdown report
appaveli-codemind analyze -f src/UserController.php --report html
appaveli-codemind analyze -f src/UserController.php --report markdown
Refactor · Generate · Secure

# Refactor code using AI
appaveli-codemind refactor -f AuthService.swift -t general_cleanup

# Generate boilerplate (e.g. Laravel controller)
appaveli-codemind generate -t laravel_controller -n UserController

# Run a full security scan
appaveli-codemind security -p ./myproject

# Example: analyze a Java file with verbose output
appaveli-codemind analyze -f Example.java -v

⚙️ Installation

Use it locally in a virtualenv or install globally with pipx.

Local (virtualenv)

python -m venv venv
source venv/bin/activate
pip install -e .
Global (pipx)

pipx install --editable .
Environment Setup

Create a .env file in the project root with your LLM API key: 


OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

🧩 Architecture Overview

A clean, layered design so you can understand and extend the tool in your own workflow.

Core Layout
  • main.py – CLI entry point
  • core/agent.py – main orchestration logic
  • core/models.py – languages & result models
  • core/language_detector.py – file type classifier
  • ai/llm_client.py – LLM client wrapper
  • utils/ – file validation, backup, formatting
Built for Extension

CodeMind is designed so you can:

  • Add new boilerplate templates.
  • Extend language detection & support.
  • Plug in different LLM providers via the client wrapper.
  • Wire the same core agent into web APIs or internal tools.