CC GUI (Claude, Codex and More)
A visual IntelliJ IDEA front end for Claude Code, OpenAI Codex and other AI coding CLIs.
- Source repo
- zhukunpenglinyutong/jetbrains-cc-gui
- Stars
- ★ 7.1k
- Last updated
- today
- License
- MIT
- Primary language
- Java
- FA score
- 46/100 · Major gaps
At a glance
- How it runs
- Works with
- Portable with changesCodex · Claude CodeOpenAI API · Claude API (Partial support)
- Cost
- Free software; you pay for model usage
- Setup effort
- Medium · a few setup steps
- You'll need
- Typical use
- Java or Kotlin developers already working in IntelliJ IDEA who want Claude Code through a GUI rather than a terminal.
- Not a fit if
- Developers outside JetBrains IDEs — the plugin only targets IntelliJ IDEA and related IDEs
- Users who want a stable, mature tool and cannot tolerate frequent iteration
- Source review
- 46/100 · Major gaps
What does this agent do, and when should you use it?
CC GUI is an IntelliJ IDEA plugin, originally called Claude Code GUI, that puts a graphical interface on top of command-line AI coding tools: Claude Code, OpenAI Codex, plus beta support for Grok CLI, Kimi CLI, OpenCode, PI CLI, OMP CLI and DeepSeek Harness. The repo is split into a webview front end, an ai-bridge layer that talks to the CLIs, and the JetBrains plugin itself, built and packaged with Gradle into a roughly 40MB plugin distributed through the JetBrains Marketplace. Inside the IDE it offers context-aware chat with @file references and image input, conversation rewind, an Agent system, Skills slash commands such as /init and /review, and MCP server support, all under permission management and security controls. Developer experience features include code DIFF review, file navigation and code jumping, dark/light themes, font scaling synced with the IDE, and automatic Chinese/English switching. Session management covers searchable history, favorites, message export, provider management compatible with cc-switch, and usage statistics. The project is MIT-licensed and under active development.
The plugin renders a chat panel as an IDEA webview and forwards user input — including @file references and images — through the ai-bridge layer to whichever CLI engine is configured: Claude Code by default, or OpenAI Codex, Grok CLI, Kimi CLI, OpenCode, PI CLI, OMP CLI and DeepSeek Harness. It invokes and runs Skills slash commands (/init, /review and others), connects to MCP servers for extra capability, and runs a built-in Agent system for multi-step tasks. Results come back as code DIFF views from which you can jump straight to the matching file and line. Alongside that, the plugin keeps searchable session history, favorites and message exports, and tracks provider settings and usage statistics.
- Java or Kotlin developers already working in IntelliJ IDEA who want Claude Code through a GUI rather than a terminal.
- Teams that want to compare Claude Code against Codex, Kimi CLI or OpenCode on the same codebase without changing tools.
- Backend engineers who need to hand precise context to the model using @file references and screenshots of requirements.
- Front-end or client developers who want to review AI-generated changes in a DIFF view and jump to the source to verify.
- Teams wiring internal workflows into an AI coding assistant through MCP servers and Skills slash commands.
- Developers who need to keep, search and export past AI sessions for later review.
- Small teams that want a visual Claude Code experience without leaving an existing JetBrains IDE.
How do you install or deploy this agent?
The shortest path is the JetBrains Marketplace: open Settings → Plugins in your IDE and search for “CC GUI (Claude or Codex)”, or install from https://plugins.jetbrains.com/plugin/29342-cc-gui-claude-or-codex-.
Building from source requires installing front-end and bridge dependencies first, then packaging with Gradle:
cd webview
npm installcd ai-bridge
npm install./gradlew clean buildPluginThe resulting plugin package lands in build/distributions/ and is about 40MB. Either way, you still need the underlying AI coding CLI (for example Claude Code) installed and configured yourself.
How do you use this agent?
After installing the plugin and restarting the IDE, open the CC GUI chat panel in IntelliJ IDEA and start a conversation. Choose the engine you want (Claude Code, OpenAI Codex, and so on) and make sure that CLI is available on your system.
To debug the plugin locally from source:
./gradlew clean runIdeIf chat or settings panels scroll sluggishly on macOS, especially on Retina displays, add this to Help → Edit Custom VM Options and restart the IDE:
-Dide.browser.jcef.gpu.disable=trueIn a conversation, use @file references to pin files, attach images to describe requirements, call Skills through slash commands such as /init and /review, and review the resulting changes in the DIFF view.
What are this agent's strengths and limitations?
- Unifies several CLI engines — Claude Code, OpenAI Codex, Grok CLI, Kimi CLI, OpenCode, PI CLI, OMP CLI, DeepSeek Harness — behind one IDEA interface you can switch between.
- Closes the loop from prompt to review with @file references, image input, conversation rewind, code DIFF and jump-to-source navigation.
- Ships an Agent system, Skills slash commands and MCP server support, so automation can be extended without leaving the IDE.
- Searchable session history, favorites, message export and usage statistics make long-term use and retrospective review practical.
- MIT-licensed, installable from the JetBrains Marketplace, and reproducible from source with a Gradle build.
- Works only inside JetBrains IDEs such as IntelliJ IDEA; there is no VS Code or standalone terminal option.
- The plugin supplies no model itself — coding ability and cost depend entirely on the external CLI and the account behind it.
- Six of the listed engines (Grok CLI, Kimi CLI, OpenCode, PI CLI, OMP CLI, DeepSeek Harness) are marked Beta, so their reliability is not yet proven.
- Building from source means managing npm dependencies in both webview and ai-bridge plus the Gradle packaging step.
- The README documents macOS scrolling lag that requires manually disabling JCEF GPU acceleration as a workaround.
How does this agent compare with similar options?
Compared with running Claude Code or the OpenAI Codex CLI directly in a terminal, CC GUI moves chat, @file references, DIFF review and session management into the IDE and lets you switch between several CLI engines; the tradeoff is that it only runs inside JetBrains IDEs.
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| CC GUI (Claude, Codex and More) This agent | 46 · Major gaps | IDE extensionFree + model costs | ★ 7.1k | today | Java | Codex · Claude Code |
| Mirafold | 89 · Good | CLIFreemium | ★ 18 | 1mo ago | TypeScript | Codex · Claude Code |
| Agent Deck | 76 · Good | CLIFree + model costs | ★ 1.1k | 1d ago | Go | Codex · Claude Code |
| ECC Engineering Harness | 66 · Some gaps | Agent plugin / skillFreemium | ★ 285k | today | JavaScript | Codex · Claude Code |
How does FollowAgents rate this agent?
Why each dimension lost points
trust: least_privilege — the docs define five distinct permission modes (default/plan/acceptEdits/auto/bypassPermissions) and state that under acceptEdits Bash and sub-agent launches still require confirmation, while Full Auto needs allowDangerouslySkipPermissions and a subprocess rebuild; that is deliberate privilege layering, so 2. Not full marks because Full Auto bypasses all ordinary checks, and the docs admit auto mode applies repository-level allow rules before the classifier, so a malicious repo can silently auto-approve. user_confirmation: the SDK permissions doc and the multimodal-permission-bug doc show both a canUseTool callback and a PreToolUse hook confirmation path, and record a real defect where confirmation was skipped for image messages plus its fix — the mechanism exists but has demonstrably been bypassed, so 2. data_flow_transparency: only the Java→Node→SDK/app-server chain and the TMPDIR/CLAUDE_PERMISSION_DIR channel are documented; there is no systematic statement of which third-party endpoints receive code, images or API keys, so 1. sensitive_data_handling: API keys are described as stored in plugin settings and the child environment is sanitized of inherited policy overrides, but there is no evidence of encrypted key storage, log redaction or image-upload scoping, so 1. dependency_security: the only claim is a README assertion that a /security-review audit runs before each minor release, unsupported by any artifact; no lockfile audit, SBOM or scanning config is visible, so 1. external_effects: the plugin writes files, runs Bash and spawns external CLIs — high side effects; there is permission gating and temp-dir cleanup but no undo for effects already applied, so 1. rollback: the docs explicitly state Codex no longer rolls edits back after decline, and Claude only offers conversation rewind rather than file rollback, so 1. source_attribution: README credits contributors, but the publisher is unverified and the repo carries both idea-claude-code-gui and jetbrains-cc-gui names, leaving the attribution chain unclear, so 1.
reliability: self_consistency — the docs contradict each other: README advertises many Beta CLIs (Grok/Kimi/OpenCode/PI/OMP/DeepSeek) while native-auto-approval-mode.md exposes auto only for Claude and Codex; CODEX-INTEGRATION-QUICKSTART.md declares itself historical and says old examples (skipGitRepoCheck, maxTurns, boolean permission IPC, post-execution rollback) are not the current runtime, yet keeps them inline; README badges still point at the old idea-claude-code-gui repo name. So 1. dependency_availability: version floors are stated (Node 22.12.0, JDK 21, Codex CLI 0.146.0, claude-agent-sdk 0.3.182) but no lockfile or dependency manifest text is in the evidence, so availability and pinning cannot be statically confirmed — 1. failure_messages: the Quickstart troubleshooting section maps four concrete failures to causes and fixes, and the auto-mode doc quotes the exact classifier-unavailable error text, so 2.
adaptability: audience_and_scenarios — README targets IntelliJ IDEA users and enumerates concrete scenarios (multi-engine, session management, DIFF, @file references, image input), so 2. capability_boundaries: Beta features are labelled, Codex is noted as lacking openedFiles IDE context, auto is limited to Claude/Codex, and Grok's internal auto alias is explicitly not repurposed — boundaries are well declared, so 2. trigger_precision: a permission flow diagram and processing order are given, but the documented defect where canUseTool does not fire for multimodal messages shows a known trigger blind spot, and @file/slash-command triggers are not precisely specified, so 1. environment_fit: coverage is JetBrains IDE on desktop with a macOS-specific performance workaround; no Linux/Windows notes or IDE version compatibility matrix, so 1.
convention: information_architecture — README is well sectioned (install, performance, features, status, dev, license, contributing) and docs are split into sdk/skills/feat/codex, so 2. install_notes: installation is a single JetBrains Marketplace link plus local dev commands; no version requirements, offline install or upgrade path, so 1. naming_stability: the project renamed from Claude Code GUI to CC GUI while idea-claude-code-gui and jetbrains-cc-gui coexist and badges still link the old name — clearly unstable, so 1. examples_and_faq: code samples and a Quickstart troubleshooting section exist, but no formal FAQ and some samples are self-declared obsolete, so 1. known_limitations: native-auto-approval-mode.md has a dedicated Known limitations section covering the claude-sonnet classifier dependency, failure on third-party relay endpoints, and repo allow-rule precedence — well disclosed, so 2. license: full MIT text with copyright holder and year, consistent with README and badge, so 3. versioning_changelog: README points to CHANGELOG.md which is not in the evidence, and versioning is only inferable from the feature/vX.Y.Z PR workflow, so 1. maintenance_responsibility: SECURITY.md commits to 48-hour acknowledgement and 3-business-day triage and the PR workflow names a single maintainer account, but publisher identity is unverified, so 1.
effectiveness: output_usability — outputs are in-IDE chat, DIFF comparison, file navigation, session export and usage stats, directly consumable, so 2. marginal_value: unifying several AI coding CLIs behind one IDE panel with a common permission-mode mapping is a real increment over using each CLI separately, so 2. cost_benefit: README cites a ~40MB package and the Quickstart cites 50–100MB RAM per active channel, plus external CLI installs and API key setup — meaningful cost against workflow-dependent benefit, so 1.
verifiability: claim_traceability — most claims (security audit cadence, test pass counts of 113 and 1,473) appear only as prose assertions with no checkable run record or CI link, so 1. cross_source_corroboration: README, the permissions doc, the auto-mode doc and the Quickstart partly corroborate each other on permission modes, but also conflict (Beta engine list, legacy Codex examples), so 1. fact_inference_separation: the docs mostly separate investigation findings, known limitations and implementation status, but the self-reported test counts under Implementation status are unverified self-assertion and the README audit promise is unsupported, so 1.
- Full Auto (bypassPermissions) bypasses all ordinary permission checks — use only in isolated environments; the docs also admit auto mode applies repository-level allow rules first, so stay in default mode when opening untrusted repositories.
- docs/skills/multimodal-permission-bug.md records a real defect where the permission prompt was skipped for image messages; a PreToolUse hook fix is described, but static review cannot confirm it is merged at this revision.
- Codex no longer rolls edits back after a decline and Claude only offers conversation rewind, so file-level side effects lack an undo path.
- README claims a security audit before each minor release, but no audit artifact, lockfile audit or vulnerability scanning config is present to support it.
- The repo carries both idea-claude-code-gui and jetbrains-cc-gui names with badges pointing at the old name, and the publisher is unverified by the FollowAgents registry — verify the Marketplace publisher before installing.
- CODEX-INTEGRATION-QUICKSTART.md declares itself historical; its skipGitRepoCheck, maxTurns and boolean permission IPC examples do not reflect the current runtime and should not be copied.