Understanding-first coding for IntelliJ

Understand the code
you ship.

Shoaku is an IntelliJ AI coding assistant plugin powered by Codex CLI.
You keep thinking and coding while an agent quietly explores another approach.

Shoaku plugin running in IntelliJ IDEA
Shoaku running in IntelliJ IDEA Copyright © 2026 JetBrains s.r.o., used with permission. IntelliJ IDEA and the IntelliJ IDEA logo are trademarks of JetBrains s.r.o.

AI can write the code.
You still have to
live with it.

Useful software lasts longer than the prompt that created it. To maintain it with confidence, someone needs to understand the choices inside.

Shoaku keeps that understanding with the team.

FOR EXPERIENCED DEVELOPERS

Keep the craft in coding.

Stay close to the problem, test your instincts, and enjoy making the decisions that matter—without turning the whole task over to an agent.

FOR DEVELOPERS BUILDING EXPERIENCE

Build judgment, not dependency.

Work through the why behind the code. Questions and comparison help turn each task into durable knowledge you can carry forward.

Understand as you build.
Compare before you finish.

Shoaku supports your understanding while an agent explores,
then brings both perspectives together at the end.

01 / WORK AT YOUR PACE

Build understanding,
step by step.

Shoaku breaks the task into smaller steps, so you can work through each one at your own pace. Each loop of asking, trying, and reflecting builds the understanding that carries you toward completion.

Step-by-step understanding builds toward achieving the goal GOAL ACHIEVED
02 / SEPARATE WORK, SHARED REVIEW

Work separately.
Compare at the end.

You and the agent code in separate workspaces, so its exploration never interrupts your pace. At the end, compare both implementations to find gaps, challenge assumptions, and strengthen the result.

YOUR WORK
AI EXPLORATION
Human work and AI exploration overlap for a final comparison

A coding workflow built for understanding.

Shoaku is designed for developers who want AI assistance without losing ownership of their code.

What is Shoaku?

Shoaku is an open-source plugin for IntelliJ IDEA. It uses Codex CLI to investigate and implement a goal in a separate workspace while you work in your own.

How does it help with AI-assisted coding?

At the end of a task, Shoaku lets you compare your implementation with the agent's work. The comparison helps reveal trade-offs, gaps, and useful alternatives before you merge or ship.

What do I need to use it?

Install Shoaku from JetBrains Marketplace, then configure Codex CLI and Node.js 22 or later in your development environment.

See the workflow in IntelliJ.

From a shared goal to the final comparison, see how Shoaku fits into real development work.

SHOAKU / PRODUCT WALKTHROUGHWatch on YouTube ↗

Build useful software.
Understand what you ship.

Bring Shoaku into your IntelliJ workflow and stay close to every decision.

Install for IntelliJ Requires Codex CLI & Node.js 22+