mdcode

AI-powered CLI coding assistant — works with any AI provider

Supports DeepSeek · OpenRouter (free models) · Google Gemini · OpenAI · Custom APIs

Install

npm install -g mdcode

Quick Start

1. Setup your provider & API key:

mdcode model

2. Go to your project:

cd my-project
mdcode          # Agent mode — AI writes code autonomously
mdcode chat     # Chat mode  — discuss, debug, advise

Commands

| Command | Description | |----------------|------------------------------------------------| | mdcode | Agent mode — AI reads, writes, runs code | | mdcode chat | Chat mode — streaming conversational help | | mdcode model | Setup — choose provider + API key + model | | mdcode help | Show help |

In-session shortcuts (Agent mode)

| Command | Action | |-------------|--------------------------| | /memory | View project memory | | /clear | Clear project memory | | exit | End session |

Supported Providers

| Provider | Free Tier | Get Key | |-------------|-----------|---------| | OpenRouter | ✅ Yes — multiple free models | openrouter.ai/keys | | Google Gemini | ✅ Yes — generous free tier | aistudio.google.com | | DeepSeek | Limited free credits | platform.deepseek.com | | OpenAI | ❌ Paid only | platform.openai.com | | Custom | Your own endpoint | — |

Free recommendation: Use OpenRouter → select DeepSeek V3 :free model

Features

• 🤖 Agent Mode — autonomous coding: creates files, edits code, runs commands
• 💬 Chat Mode — streaming conversation with fallback for all providers
• 🧠 Per-Project Memory — .mdcode/memory.md remembers context across sessions
• 🔐 Safe — asks approval before every write/run operation
• 🔌 Multi-Provider — switch any time with mdcode model
• 🛠️ Full Stack Skills — React, Next.js, Vue, Node, Python, databases, Docker

Project Memory

Each project folder gets its own .mdcode/memory.md. The AI uses this to remember your tech stack, architecture, env vars, and patterns across sessions.

Add to your .gitignore if it contains sensitive info:

.mdcode/

Requirements

• Node.js 18+
• API key from any supported provider

Made by Maleesha Dewshan