π€ 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)
npx @johnolven/asis-coder setup
π¦ Option 2: Global Installation
npm install -g @johnolven/asis-coder
coder setup
coder -i
coder "explain this project"
β οΈ Option 3: Local Installation (Not recommended)
npm install @johnolven/asis-coder
npx @johnolven/asis-coder setup
π₯οΈ 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
npx @johnolven/asis-coder -i
npx @johnolven/asis-coder "question"
π Quick Start
With Global Installation:
-
Install globally:
npm install -g @johnolven/asis-coder
-
Initial Setup:
coder setup
-
Generate Project Context:
coder -context
-
Ask Questions:
coder "explain this project structure"
coder "how can I optimize this code?"
-
Interactive Mode:
coder -i
With NPX (no installation):
-
Initial Setup:
npx @johnolven/asis-coder setup
-
Generate Project Context:
npx @johnolven/asis-coder -context
-
Ask Questions:
npx @johnolven/asis-coder "explain this project structure"
npx @johnolven/asis-coder "how can I optimize this code?"
-
Interactive Mode:
npx @johnolven/asis-coder -i
π§ 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
):
coder setup
coder -token
coder -model
coder -llm
coder -context
coder -project
coder "your question"
coder -i
coder -history
coder -test
coder -clean
coder -help
If using npx (no installation):
npx @johnolven/asis-coder setup
npx @johnolven/asis-coder -token
npx @johnolven/asis-coder -model
npx @johnolven/asis-coder -llm
npx @johnolven/asis-coder -context
npx @johnolven/asis-coder -project
npx @johnolven/asis-coder "your question"
npx @johnolven/asis-coder -i
npx @johnolven/asis-coder -history
npx @johnolven/asis-coder -test
npx @johnolven/asis-coder -clean
npx @johnolven/asis-coder -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
Switch Between Models
coder -model
coder -llm
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
Switch Between Models
npx @johnolven/asis-coder -model
npx @johnolven/asis-coder -llm
ποΈ 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:
- OpenAI API Key (for ChatGPT)
- Anthropic API Key (for Claude)
- 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
π 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!