IntelliJ 2024.1 — 2026.1+
LunaOS for IntelliJ
Run AI agents, browse workflows, and stream execution logs without leaving your IDE.
1
Install the Plugin
Option A — From JetBrains Marketplace
- Open IntelliJ IDEA (or any JetBrains IDE)
- Go to Settings → Plugins → Marketplace
- Search for
LunaOS - Click Install and restart the IDE
Option B — Build from source
git clone https://github.com/lunaos-ai/lunaos-intellij.git
cd lunaos-intellij
./gradlew buildPlugin
# Install from: build/distributions/LunaOS-1.0.0.zip
# Settings → Plugins → ⚙️ → Install from Disk...2
Connect to LunaOS
After installing, configure your API connection:
- Go to Settings → Tools → LunaOS
- Enter your API endpoint:
https://api.lunaos.ai - Paste your API key (get one at agents.lunaos.ai/dashboard/api-keys)
- Click Test Connection to verify
- Optionally set a Default Agent ID for editor context actions
3
Start Using
The plugin adds interactive UI across your IDE:
Tool Window (Right Panel)
3 tabs: Agents (search + run), Runs (sortable table), Logs (real-time stream). Open from the right sidebar.
Tools Menu
Tools → LunaOS — Run Agent (Ctrl+Alt+L), Browse Agents, View Recent Runs.
Editor Context Menu
Select code → right-click → Analyze with LunaOS Agent. Uses your default agent.
Status Bar
Bottom-right shows active run count. Click to open the LunaOS panel.
4
Keyboard Shortcuts
Ctrl+Alt+L— Open agent picker and run- Right-click selected code → Analyze with LunaOS Agent
- Click status bar widget → Opens LunaOS tool window