AIcoder CLI — BYOK AI coding assistant with local fallback. Built by Nainacore Emotional Tech 🌐 https://www.nainaaicreation.com 🌐 https://nees.cloud
AIcoder CLI is a terminal-first AI coding assistant designed for developers who want control, transparency, and resilience in their AI workflows. It follows a simple principle:
AI should be controlled, not rented.
- Bring your own API key (BYOK)
- Run inside your environment
- No platform lock-in
- No hidden abstraction
- Fully transparent execution flow
Most AI tools optimize for:
- subscriptions
- lock-in
- hidden usage
AIcoder explores the opposite:
Developer-first AI infrastructure
AIcoder is designed to never leave you stuck.
- Primary: use cloud provider (OpenAI / Anthropic)
- Fallback: automatically switch to local (Ollama)
- No silent failures
- Clear runtime messaging
Example:
Primary provider 'openai' unavailable (insufficient quota). Falling back to local Ollama.
Features
aicoder doctor
aicoder scan
aicoder summarize
aicoder ask "Where is auth logic?"
aicoder plan "Add feature X"
aicoder edit "Implement Y safely"
Highlights:
🔍 Repo-aware scanning
🧠 AI-assisted understanding
📄 Persistent planning system
🛠 Controlled code editing
🔁 Multi-provider fallback
🖥 Local AI support (Ollama)
🧾 Plan-File Workflow (Game Changer)
aicoder plan "Add feature X"
aicoder edit "Implement feature X safely"
Creates:
.AICoder_Plan.md
Workflow:
Plan is generated and saved
Developer reviews the plan
Edit uses the same plan
Plan → Review → Execute
No blind AI actions.
🔌 Multi-Provider + Fallback
Supported flow:
Try configured provider
If it fails (auth/quota/network)
Automatically fallback to local Ollama
Fallback triggers include:
missing API key
invalid authentication
insufficient quota
rate limiting
network failure
SDK missing
🖥 Local Setup (Ollama)
export AICODER_FALLBACK_PROVIDER=local
export LOCAL_MODEL_URL=http://localhost:11434
export LOCAL_MODEL_NAME=qwen2.5-coder:7b
ollama serve
ollama pull qwen2.5-coder:7b
📦 Installation
python -m venv .venv
.venv\Scripts\activate
python -m pip install -e .
Verify:
aicoder --help
⚙️ Configuration
OpenAI example
export AICODER_PROVIDER=openai
export OPENAI_API_KEY=your_key_here
export AICODER_FALLBACK_PROVIDER=local
export AICODER_MODEL=gpt-4.1-mini
Windows PowerShell
$env:AICODER_PROVIDER = "openai"
$env:OPENAI_API_KEY = "your_key_here"
$env:AICODER_FALLBACK_PROVIDER = "local"
$env:AICODER_MODEL = "gpt-4.1-mini"
🚀 Usage
aicoder doctor
aicoder scan
aicoder summarize
aicoder ask "Where is authentication handled?"
aicoder plan "Add logging improvements"
aicoder edit "Implement logging safely"
⚠️ Current Limitations
Requires working provider or local Ollama
edit is controlled (not autonomous agent)
Internal architecture still evolving
Advanced intelligence layers not yet exposed
💬 Message for Developers
If you’ve ever felt:
“Why am I paying just to use AI?”
“Why is my workflow locked inside tools?”
“Why can’t I control my own AI usage?”
This project is for you.
👉 AIcoder is not just a tool.
👉 It’s a direction.
😄 Message for “Smart Pirates”
Yes, we know:
You will fork it
You will modify it
You will try to rebuild it
Go ahead.
But remember:
Code is easy to copy.
Vision is not.
This project is about **rethinking AI infrastructure**.
If you just copy the code, you miss the point.
👉 (Coming Soon)
smarter repo
🏢 About Nainacore Emotional Tech
AIcoder CLI is part of a larger vision:
NEES — Nainacore Emotional Engine System
Building:
intent-aware AI
emotionally intelligent systems
developer-controlled AI infrastructure
🌐 https://www.nainaaicreation.com
🌐 https://nees.cloud
📜 License
MIT License — free to use, modify, and distribute.
⭐ Support
If this helps you:
⭐ Star the repo
🍴 Fork it
🧠 Contribute ideas
⭐ Star the repo
🍴 Fork it
🧠 Contribute ideas