Getting Started
Quick Start
Get up and running with Coodeen in under a minute.
Requirements
- Node.js 18+
- An API key from at least one supported AI provider
Install and Run
Using npx (recommended)
cd ~/my-project
npx coodeenGlobal install
npm install -g coodeen
coodeenOn first run, Coodeen will:
- Create
~/.coodeen/for your local database - Initialize the SQLite database automatically
- Start the server on port 3099
- Open your browser to
http://localhost:3099/editor/
Configure a Provider
Click the gear icon in the top bar to open Settings. Add an API key for at least one provider:
| Provider | Get API Key | Models |
|---|---|---|
| OpenAI | platform.openai.com | GPT-4o, GPT-4.1, GPT-4.1-mini |
| Anthropic | console.anthropic.com | Claude Sonnet, Claude Haiku |
| aistudio.google.com | Gemini 2.5 Pro, Gemini 2.5 Flash |
Example Workflow
# 1. Navigate to your project
cd ~/my-app
# 2. Start Coodeen
npx coodeen
# 3. Browser opens to http://localhost:3099/editor/
# 4. Add your API key in Settings
# 5. Point the preview panel to your dev server (e.g. http://localhost:3000)
# 6. Start chatting — ask the AI to build features, fix bugs, or explain code
# 7. Capture screenshots from the preview to give the AI visual context