Installation

npm install -g iodine-ide

Requires Node.js 18+ and at least one AI provider API key (Anthropic, OpenAI, or Google).

export ANTHROPIC_API_KEY=sk-ant-...   # or OPENAI_TOKEN / GEMINI_API_KEY

iodine

On Windows (PowerShell), set the key permanently, then restart your terminal and run iodine:

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "<your-key>", "User")   # or OPENAI_TOKEN / GEMINI_API_KEY

Anthropic keys are also auto-detected from ~/.anthropic/api_key (on Windows: %USERPROFILE%\.anthropic\api_key).

Opens in your browser at http://localhost:3001. To use a different port: PORT=4000 iodine.

To update: npm install -g iodine-ide@latest.

Features

• Mentor mode — guided walkthroughs that open files, highlight lines, and explain one block at a time without making changes
• Live voice sessions — real-time conversation via Gemini Live that reads files, navigates code, and drops a full transcript back into the chat
• Polished documentation — cached per-file and per-directory summaries with a Markdown preview and table-of-contents sidebar
• System View — interactive architecture graph generated from the codebase; nodes link back to source locations
• Supports Anthropic Claude, OpenAI GPT, and Google Gemini

Running from source

git clone https://github.com/hyunwookshin/iodine.git
cd iodine
npm install
cp .env.example .env  # add your API keys
npm run dev

• Client: http://localhost:5173
• Server: http://localhost:3001

npm test           # run the test suite
npm run build      # production build
npm run typecheck  # TypeScript checks across the monorepo

For architecture details and contributor workflows, see CONTRIBUTING.md.