Skip to content

installation.md

Latest commit

 

History

History
72 lines (47 loc) · 3.01 KB

installation.md

File metadata and controls

72 lines (47 loc) · 3.01 KB
Raw

Installation & Build

Requirements

Requirement Minimum version
Apache NetBeans IDE 23 (RELEASE230)
Java 17
Claude Code CLI (claude) 2.1.78

Note: The plugin has been tested with Claude Code CLI 2.1.78 and newer. Older versions may not work correctly.

Terminal font (recommended): The plugin auto-selects the best available monospace font. For full Unicode coverage of Claude Code TUI symbols (spinner ◐, prompt marker ⏵, box-drawing characters), install Adwaita Mono. On Linux it is typically pre-installed as part of the GNOME desktop. On macOS and Windows, download it from the GNOME GitLab release page. The active font can be changed in Tools → Options → Claude Code → General.

The claude executable must be on your system PATH or its absolute path must be configured in Tools → Options → Claude Code → General → Claude CLI path after installing the plugin.

Installation

NetBeans Plugin Portal

The plugin is available in the NetBeans Plugin Portal. Open NetBeans → Tools → Plugins → Available Plugins, search for Claude Code GUI, and click Install.

Note: Due to the plugin portal's publication cycle, the version available there may be older than the latest release on GitHub. If you need the newest version, download it directly from GitHub Releases.

Recommended: download from GitHub Releases

Download the latest .nbm file from the Releases page.

Intermediate builds

Builds between releases are available as artifacts on the Actions page — open the latest successful workflow run and download the nbm artifact (delivered as a zip file; extract the .nbm before installing).

Install into NetBeans

  1. Open NetBeans → Tools → Plugins
  2. Switch to the Downloaded tab
  3. Click Add Plugins… and select the .nbm file
  4. Click Install and follow the wizard
  5. Restart NetBeans when prompted

Uninstall

  1. Open NetBeans → Tools → Plugins
  2. Switch to the Installed tab
  3. Make sure Show details is checked — otherwise only group entries are shown and individual plugins cannot be selected
  4. Check the checkbox next to Claude Code GUI in the Select column
  5. Click Uninstall
  6. Restart NetBeans when prompted

Build from Source

mvn nbm:nbm

The installable plugin file is created at:

target/netbeans-claude-code-gui-*.nbm

Other build commands

mvn package              # Full build with tests
mvn package -DskipTests  # Build without tests
mvn test                 # Run all unit tests