Quick Start

Download

The homepage currently serves the macOS (Apple Silicon) build:

Other artifacts (if any) are listed under all releases.

Install (macOS)

1. Open the .dmg and drag Coodeen to Applications.

2. Clear the Gatekeeper quarantine attribute so the unsigned app can launch:

   xattr -cr /Applications/Coodeen.app

3. Open Coodeen from Applications.

Add Your OpenAI Key

1. Click the key icon in the top-right of the top bar.
2. Paste an OpenAI key (sk-...) from platform.openai.com/api-keys.
3. Save — the key is stored in opencode's auth store at ~/.local/share/opencode/auth.json.

The current UI only wires OpenAI through the dialog. To use other providers, edit opencode's auth file directly.

Pick a Project Folder

Coodeen starts in the process's cwd. Use the project picker (folder UI inside the app) to point the agent at your repo. Every opencode request is scoped to that directory.

First Prompt

1. Point the preview panel at your dev server (default http://localhost:3000).
2. Type a request in the composer — "explain the router", "add dark mode", whatever.
3. Watch tool calls render inline as the agent reads and edits files.
4. Click an element in the preview to screenshot it and attach the image to the next message.

Optional: Custom Action Buttons

Drop a coodeen.json in your project root:

{
  "actions": [
    { "label": "Dev", "script": "bun run dev" },
    { "label": "Test", "script": "bun run test" }
  ]
}

Each entry shows up in the top bar and runs script via sh -c in the project directory, with .env loaded.