ccw-maven-setup

CCW Maven Setup Skill

Prepares the Maven build environment for Claude Code Web (CCW) by installing Java 25 and configuring the Maven proxy. Does nothing in local environments.

Purpose

This skill ensures that Maven builds work correctly in Claude Code Web by:

1. Installing Java 25 (required by this project)
2. Setting up a local Maven authentication proxy
3. Configuring Maven settings.xml

When to Use

Run this skill before any Maven build operations when working in Claude Code Web. It's idempotent and safe to run multiple times.

What It Does

1. Detects environment: Checks CLAUDECODE environment variable
2. If in CCW:
   • Installs SDKMAN (if not present)
   • Installs latest stable Java 25 (Temurin distribution) via SDKMAN
   • Starts local Maven authentication proxy at 127.0.0.1:3128
   • Configures ~/.m2/settings.xml with proxy settings
3. If not in CCW:
   • Does nothing (assumes local environment already has Java 25)

Usage

Simply run the prep script from the skill directory:

bash support/shared/claude/skills/ccw-maven-setup/prep_if_ccw.sh

Or invoke as a skill (after properly registered):

/skill ccw-maven-setup

Skill Workflow

When invoked, execute these steps:

1. Run the preparation script:

   bash "$CLAUDE_PROJECT_DIR/support/shared/claude/skills/ccw-maven-setup/prep_if_ccw.sh"
   

2. Verify setup by checking:

   • Java version: java -version (should show Java 25)
   • Maven proxy: cat ~/.m2/settings.xml (should show proxy config)
   • Proxy process: pgrep -f maven-proxy.py (should be running in CCW)

3. Report results to user with summary of what was set up

Technical Details

Why a Local Proxy?

Maven doesn't honor standard HTTP_PROXY environment variables for authentication. The local proxy at 127.0.0.1:3128 handles authentication transparently by:

• Accepting unauthenticated CONNECT requests from Maven
• Adding authentication headers when forwarding to CCW's upstream proxy
• Maintaining persistent connections for better performance

Script Location

The prep_if_ccw.sh script is located in:

support/shared/claude/skills/ccw-maven-setup/prep_if_ccw.sh

This location is vendor-controlled and shared across projects that need CCW Maven support.

References

• GitHub Issue: https://github.com/anthropics/claude-code/issues/13372
• LinkedIn Article: https://www.linkedin.com/pulse/fixing-maven-build-issues-claude-code-web-ccw-tarun-lalwani-8n7oc
• SDKMAN: https://sdkman.io/

SessionStart Hook Integration

This skill is designed to run automatically via a SessionStart hook. See .claude/settings.json for hook configuration that runs this setup at session start.