@johnolven/asis-coder

🤖 Asis-coder

Your AI Development Assistant - A modular CLI that connects your code with ChatGPT, Claude, and Gemini for enhanced development workflow.

✨ Features

• 🧠 Multi-LLM Support: ChatGPT, Claude, and Gemini integration
• 📁 Smart Project Detection: Automatically detects your project type and context
• 💬 Interactive Mode: Real-time streaming conversations with AI
• 🔧 Modular Architecture: Clean, maintainable codebase with specialized modules
• 🌐 Cross-Platform: Works on macOS, Linux, and Windows
• ⚡ Context Generation: Automatically includes relevant project files
• 🎯 30+ AI Models: Support for latest models from all providers

⚡ Installation Options

🚀 Option 1: NPX (Recommended)

# Run directly without installing anything
npx @johnolven/asis-coder setup

📦 Option 2: Global Installation

# Install globally to use 'coder' command everywhere
npm install -g @johnolven/asis-coder

# Then use short commands:
coder setup
coder -i
coder "explain this project"

⚠️ Option 3: Local Installation (Not recommended)

# Local install still requires npx to run
npm install @johnolven/asis-coder
npx @johnolven/asis-coder setup  # Still need npx!

🖥️ Platform Compatibility

✅ macOS and Linux

Full automatic installation. The coder command will be available globally.

⚠️ Windows

Requires one of these environments:

• Git Bash (included with Git for Windows) - ⭐ Recommended
• WSL (Windows Subsystem for Linux)
• PowerShell with bash available

On Windows use:

npx @johnolven/asis-coder setup    # Initial configuration
npx @johnolven/asis-coder -i       # Interactive mode
npx @johnolven/asis-coder "question"  # Direct query

🚀 Quick Start

With Global Installation:

1. Install globally:

   npm install -g @johnolven/asis-coder

2. Initial Setup:

   coder setup  # Configure your API keys

3. Generate Project Context:

   coder -context  # Analyze your project

4. Ask Questions:

   coder "explain this project structure"
   coder "how can I optimize this code?"

5. Interactive Mode:

   coder -i  # Start interactive session

With NPX (no installation):

1. Initial Setup:

   npx @johnolven/asis-coder setup  # Configure your API keys

2. Generate Project Context:

   npx @johnolven/asis-coder -context  # Analyze your project

3. Ask Questions:

   npx @johnolven/asis-coder "explain this project structure"
   npx @johnolven/asis-coder "how can I optimize this code?"

4. Interactive Mode:

   npx @johnolven/asis-coder -i  # Start interactive session

🧠 Supported AI Models

ChatGPT (OpenAI) - 14 Models

• GPT-4o, GPT-4o-mini
• GPT-4 Turbo, GPT-4
• GPT-3.5 Turbo variants
• And more...

Claude (Anthropic) - 8 Models

• Claude 3.5 Sonnet
• Claude 3 Opus, Sonnet, Haiku
• Claude 2.1, 2.0
• Claude Instant variants

Gemini (Google) - 8 Models

• Gemini 1.5 Pro, Flash
• Gemini 1.0 Pro variants
• Gemini Pro Vision
• And more...

📋 Available Commands

If installed globally (npm install -g @johnolven/asis-coder):

# Configuration
coder setup                    # Initial setup wizard
coder -token                   # Update API tokens
coder -model                   # Change AI model
coder -llm                     # Switch LLM provider

# Project Analysis
coder -context                 # Generate project context
coder -project                 # Detect project type

# Interaction
coder "your question"          # Direct query
coder -i                       # Interactive mode
coder -history                 # View conversation history

# Utilities
coder -test                    # Test API configuration
coder -clean                   # Clear conversation history
coder -help                    # Show help

If using npx (no installation):

# Configuration
npx @johnolven/asis-coder setup                    # Initial setup wizard
npx @johnolven/asis-coder -token                   # Update API tokens
npx @johnolven/asis-coder -model                   # Change AI model
npx @johnolven/asis-coder -llm                     # Switch LLM provider

# Project Analysis
npx @johnolven/asis-coder -context                 # Generate project context
npx @johnolven/asis-coder -project                 # Detect project type

# Interaction
npx @johnolven/asis-coder "your question"          # Direct query
npx @johnolven/asis-coder -i                       # Interactive mode
npx @johnolven/asis-coder -history                 # View conversation history

# Utilities
npx @johnolven/asis-coder -test                    # Test API configuration
npx @johnolven/asis-coder -clean                   # Clear conversation history
npx @johnolven/asis-coder -help                    # Show help

🌟 Usage Examples

With Global Installation (npm install -g @johnolven/asis-coder):

Basic Query

coder "What's the best way to optimize this React component?"

Project Analysis

coder -context
coder "Analyze the architecture of this project and suggest improvements"

Interactive Development Session

coder -i
# Start a conversation about your code
# Get real-time suggestions and explanations

Switch Between Models

coder -model  # Choose from 30+ available models
coder -llm    # Switch between ChatGPT, Claude, Gemini

With NPX (no installation needed):

Basic Query

npx @johnolven/asis-coder "What's the best way to optimize this React component?"

Project Analysis

npx @johnolven/asis-coder -context
npx @johnolven/asis-coder "Analyze the architecture of this project and suggest improvements"

Interactive Development Session

npx @johnolven/asis-coder -i
# Start a conversation about your code
# Get real-time suggestions and explanations

Switch Between Models

npx @johnolven/asis-coder -model  # Choose from 30+ available models
npx @johnolven/asis-coder -llm    # Switch between ChatGPT, Claude, Gemini

🏗️ Architecture

Asis-coder features a modular architecture with specialized components:

• lib/config.sh: System configuration and environment setup
• lib/api_validation.sh: API key validation and testing
• lib/llm_models.sh: LLM provider and model management
• lib/project_manager.sh: Project detection and context generation
• lib/ui_interface.sh: User interface and guided configuration
• lib/llm_communication.sh: AI communication and streaming

📁 Project Detection

Automatically detects and optimizes for:

• Web: React, Vue, Angular, HTML/CSS/JS
• Backend: Node.js, Python, PHP, Ruby
• Mobile: React Native, Flutter
• Desktop: Electron, .NET
• Data: Jupyter, R, MATLAB
• DevOps: Docker, Kubernetes, CI/CD
• And many more...

🔧 Configuration

API Keys Setup

The setup wizard will guide you through configuring:

1. OpenAI API Key (for ChatGPT)
2. Anthropic API Key (for Claude)
3. Google AI API Key (for Gemini)

Environment Variables

You can also set environment variables:

export OPENAI_API_KEY="your-key"
export ANTHROPIC_API_KEY="your-key"
export GOOGLE_AI_API_KEY="your-key"

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• npm Package
• GitHub Repository
• Issues & Support

🙏 Acknowledgments

Built with ❤️ for developers who want to enhance their coding workflow with AI assistance.

---

Made with 🤖 AI assistance - Asis-coder is itself built using AI-powered development!