JetBrains Plugin

Service dashboard, log streaming, and full control of your fuku stack — inside GoLand, IntelliJ IDEA, WebStorm, or any JetBrains IDE.

Get the plugin

Download the latest plugin ZIP from the GitHub releases page, then install it manually:

1. Open your JetBrains IDE
2. Go to Settings → Plugins → ⚙ → Install Plugin from Disk
3. Select the downloaded fuku-jetbrains-*.zip
4. Restart the IDE

Connect to fuku

The plugin connects to a running fuku instance via its REST API. Configure the connection at Settings → Tools → Fuku:

Use Test Connection to verify the setup. It validates both connectivity and authentication.

Monitor your services

The services tab shows all running services grouped by tier, matching the TUI layout:

• Status indicator — colored ◉ dot per service with blink animation during transitions
• Timeline — per-service status history (green running, amber starting, red failed, gray stopped)
• Metrics — CPU, memory, PID, and uptime updated every poll cycle
• Error display — failed services show the error message inline
• Tier grouping — services grouped under tier headers, same as TUI

Keyboard-driven

All TUI shortcuts work in the services tab:

Live logs

The logs tab streams logs in real-time from fuku's Unix socket relay — the same protocol as fuku logs. Service names are color-coded using the same 24-color palette as the TUI.

Press / in the logs tab to search. Logs auto-connect when fuku starts and reconnect on profile changes.

Run from the IDE

The plugin adds a fuku run configuration type. Go to Run → Edit Configurations → + → fuku to create one.

Select a profile from the dropdown — the plugin reads profiles from fuku.yaml and fuku.override.yaml (with .yml fallback, matching core discovery).

You can also use the profile selector and Run button directly in the fuku tool window toolbar.

Failure alerts

When a service fails, the plugin shows an IDE balloon notification with the error message and a Restart action button. Actions are only available when fuku is in the running phase.

At a glance

The status bar widget shows the current state:

• fuku: ⠧ starting storage… — animated spinner during startup
• fuku: running 5/5 ready — all services healthy
• fuku: disconnected — fuku not running

Click the widget to open the fuku tool window.

Compatibility

• IDE — IntelliJ IDEA, GoLand, WebStorm, PyCharm, or any JetBrains IDE (2024.3+)
• Platform — macOS, Linux (Unix domain sockets required for log streaming)
• fuku — v0.19.0 or later (REST API + socket relay)