Build Convex
SkillDev toolsBuild the Convex project from source. Use when a contributor wants to compile, test, or package Convex.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Build Convex skill
What this skill tells your AI
The instructions your AI receives, as published by convex-dev/convex in .agents/skills/build-convex/SKILL.md and read by ahel’s review.
Build the Convex Maven project. Requires Java 21+ (JDK 25 recommended). The checked-in wrapper supplies the pinned Maven version.
Run every command from the repository root — that is already the working
directory, so do not cd anywhere first. Use ./mvnw on Unix-like shells or
.\mvnw.cmd in PowerShell so the build uses the pinned Maven version.
Parse $ARGUMENTS for a module name (any argument starting convex-),
e.g. convex-core.
Fast incremental build
The default when no arguments are given:
./mvnw -B -T1C test
Build a single module
./mvnw -B -T1C test -pl <module> -am
-am also builds the modules that one depends on.
Final verification
Use a clean, sequential build before claiming work is done:
./mvnw -B clean install
For a single module's tests:
./mvnw -B -T1C test -pl <module> -am
Report the result — success or failure — and any errors, concisely. On failure, quote the first real compilation or test error rather than the Maven summary.
Signals
- GitHub stars
- 117
- Forks
- 47
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
build-convex- Source
- github.com/convex-dev/convex