ani-code-ai

🚀 Ani Code - The Ultimate AI Coding Assistant

The coding assistant that thinks like you - Ani Code is a comprehensive AI assistant that transforms the way you code with automated testing, security analysis, and intelligent integration.

✨ Why Ani Code?

• 🤖 Smart AI - Multiple specialized AI agents (Backend, Frontend, Security)
• 🧪 Automated Tests - Intelligent test generation and execution
• 🔒 Integrated Security - Automatic vulnerability scans
• 📊 TypeScript Migration - JS → TS conversion in one click
• 🎨 Modern Interface - Elegant and intuitive TUI
• 🔄 CI/CD Ready - Full GitHub Actions integration

🎯 Quick Installation

Via npm (recommended)

npm install -g ani-code
ani --help

Via Git

git clone https://github.com/hervekom37/Ani_Code.git
cd Ani_Code

Automated Installation (Recommended)

Windows:

.\install.ps1

Linux/macOS:

chmod +x install.sh
./install.sh

Manual Installation

npm install
npm run build
npm link

🚀 Get Started in 30 seconds

# 1. Initialize your project
ani init

# 2. Add E2E tests
ani add-playwright

# 3. Scan for vulnerabilities
ani bug-scan

# 4. Generate CI/CD tests
ani generate-tests --ci --e2e --playwright

🛠️ Essential Commands

Command	Description	Usage
ani	Interactive interface	ani
ani add-playwright	Add Playwright E2E	ani add-playwright
ani bug-scan	Scan for bugs & security	ani bug-scan --pr
ani run-tests	Run all tests	ani run-tests
ani generate-tests	Generate tests + CI/CD	ani generate-tests --ci --e2e
ani migrate-ts	Migrate to TypeScript	ani migrate-ts
ani bg-agent	Automation agent	ani bg-agent --watch

🎮 Interactive Interface

ani

Available slash commands:

• /help - Full help
• /login - AI provider login
• /model - Choose AI model
• /clear - Clear history
• /context - Manage project context

🧪 Complete QA System

1. Automated tests

# Unit tests
ani run-tests unit

# E2E tests
ani run-tests e2e

# Playwright tests
ani run-tests playwright

2. Security analysis

# Local scan
ani bug-scan

# PR scan (CI/CD)
ani bug-scan --pr

3. Intelligent generation

# Tests + CI/CD complet
ani generate-tests --ci --e2e --playwright

# Migration TypeScript
ani migrate-ts

💡 Testing Tips & Best Practices

🎯 Quick Start Testing

# 30-second complete testing setup
ani init
ani generate-tests --ci --e2e --playwright
ani bug-scan --local
ani run-tests

🎮 CLI vs TUI Usage

• CLI: ani generate-tests --ci --e2e --playwright
• TUI: ani → /generate-tests → select options interactively

🔧 Essential Testing Commands Reference

Command Type	CLI Command	TUI Slash Command
Full Setup	ani generate-tests --ci --e2e --playwright	/generate-tests
Security Scan	ani bug-scan --local	/bug-scan --local
Run Tests	ani run-tests	/run-tests
Background Agent	ani bg-agent --watch	/bg-agent --watch
Playwright Setup	ani add-playwright	/add-playwright

📋 Testing Workflow Examples

For New Projects

mkdir my-app && cd my-app
ani init
ani generate-tests --ci --e2e --playwright  # Complete testing suite
ani bug-scan --local                          # Security check
ani run-tests                                 # Execute all tests
ani bg-agent --watch &                        # Continuous monitoring

For Existing Projects

ani bug-scan --local      # Identify issues
ani generate-tests src/   # Add missing tests
ani run-tests             # Validate current state
ani migrate-ts             # TypeScript migration if needed

Daily Development

ani run-tests --watch     # Auto-run tests on changes
ani bug-scan --pr         # Pre-commit security check
ani bg-agent --watch      # Background test generation

📊 Testing Features Overview

• Unit Tests: Jest with coverage reporting
• E2E Tests: Playwright with visual testing
• Security: Automated vulnerability scanning
• CI/CD: GitHub Actions workflow generation
• Performance: Load testing capabilities
• Monitoring: Real-time test generation

📖 Complete Testing Guide

For detailed testing scenarios and examples, see: TEST_SCENARIO.md

⚡ Quick Testing Tips

• Always run security scans: ani bug-scan --local before commits
• Use watch mode: ani bg-agent --watch for continuous testing
• Generate tests early: Use ani generate-tests at project start
• Check coverage: Tests generate 95%+ coverage reports automatically
• CI/CD ready: All tests integrate with GitHub Actions

🎯 Testing Best Practices

• Test pyramid: Unit → Integration → E2E tests
• Security first: Regular vulnerability scanning
• Continuous testing: Background agent for real-time updates
• Type safety: TypeScript migration with full test coverage
• Documentation: Auto-generated test reports in context/

🔄 CI/CD Integration

The system automatically generates:

• ✅ GitHub Actions workflow
• 📊 Coverage reports
• 🔍 Security audits
• 🧪 Multi-node testing
• 📦 Artifact uploads

🎨 Customization

AI Providers Configuration

# OpenRouter (recommended)
ani login
# → Select OpenRouter

# Or manual configuration
export OPENROUTER_API_KEY="your-key"
export ANTHROPIC_API_KEY="your-key"
export OPENAI_API_KEY="your-key"

Adding New Tools

// src/tools/tool-schemas.ts
export const MY_TOOL_SCHEMA = {
  type: 'function',
  function: {
    name: 'my_tool',
    description: 'Clear description',
    parameters: { /* ... */ }
  }
};

📁 Project Structure

ani-code/
├── src/
│   ├── agents/          # Specialized AI agents
│   ├── commands/        # CLI commands
│   ├── core/           # Application core
│   ├── knowledge-graph/ # Context system
│   ├── tools/          # AI tools
│   ├── ui/             # TUI interface
│   └── utils/          # Utilities
├── context/            # Project documentation
├── docs/               # Technical documentation
└── package.json        # Configuration

🎯 Use Cases

New Project

mkdir my-project && cd my-project
ani init
ani add-playwright
ani generate-tests --ci --e2e --playwright
ani migrate-ts

Existing Project

# Quick audit
ani bug-scan

# Add missing tests
ani generate-tests src/

# TypeScript migration
ani migrate-ts

Daily Development

ani bg-agent --watch    # Auto monitoring
ani run-tests          # Quick tests
ani bug-scan --local   # Pre-commit check

🔧 Advanced Configuration

Configuration File

Create ~/.ani-code-config.json :

{
  "defaultModel": "anthropic/claude-3.5-sonnet",
  "temperature": 0.7,
  "maxTokens": 4000,
  "debug": false
}

Environment Variables

# API Keys
export OPENROUTER_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-..."
export OPENAI_API_KEY="sk-..."

# Configuration
export ANI_DEBUG=true
export ANI_MODEL="anthropic/claude-3.5-sonnet"

📊 Statistics & Monitoring

• 📈 Test Coverage : 95% with detailed report
• 🔒 Security : Daily automatic scans
• ⚡ Performance : Automatic bundle optimization
• 📊 Monitoring : Detailed logs in context/AGENT_MEMORY.md

🤝 Contribution

• Fork the project
• Create a feature branch
• Test with npm test
• Submit a Pull Request

📞 Support & Communauté

• Issues : GitHub Issues
• Discussions : GitHub Discussions
• Discord : Ani Code Community

📄 License

MIT License - see LICENSE for details.

⭐ If this project helps you, don't hesitate to give it a star!