Repository navigation
jdx v1.7.0 — annotated views, jar metadata, Kotlin-true, setup complete
Minor release: six new query commands (annotated, literals, services,
modules, manifest, resources), Kotlin views that stop lying about
nullability and file facades, override-aware callers, and the last two
jdx setup backends (Windsurf + Aider) — the setup umbrella is now the full
ten agents. Plus a native Windows installer path. Exit codes are unchanged;
existing query shapes keep working. New commands and flags are additive.
Install
curl -fsSL https://raw.githubusercontent.com/MohammadMD1383/jdx/main/install-release.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/MohammadMD1383/jdx/main/install-release.ps1 | iexOr download jdx-1.7.0-windows.zip from the assets below and run
install-release.ps1 / sh install-release.sh --tarball jdx-1.7.0-windows.zip.
Release installs self-update with jdx upgrade.
Releases are unsigned: expect a first-run warning —
Unblock-Fileon
Windows (PowerShell),xattr -d com.apple.quarantine <install-dir>/jdxon
macOS.
jdx annotated + annotation --where (issue #26)
Dedicated annotation-driven view (also reachable as usages --kind annotation):
$ jdx annotated forRemoval --limit 5
$ jdx annotated 'Deprecated(forRemoval=true)'
$ jdx usages java.lang.Deprecated --kind annotation --where forRemoval=trueRecipe aliases: deprecated, forRemoval, test/junit5, junit4, bean.
--where key=value is repeatable (AND), understands dotted nested paths and
order-insensitive {…} arrays, and merges AnnotationDefault for omitted
elements when matching (printed @use stays explicit). Annotation-use spelling
on the CLI omits the leading @ (Clikt @file); MCP accepts @Type(k=v).
Jar metadata & resources (issue #25)
| Command | Answers |
|---|---|
jdx services [pattern] |
META-INF/services SPI registrations |
jdx modules [pattern] |
JPMS module-info (requires/exports/opens/uses/provides) |
jdx manifest [pattern] |
MANIFEST.MF main attributes; --entries for JarEntry attrs |
jdx resources [pattern] |
Non-class resource paths; --cat extracts unique text content |
jdx literals (issue #86)
Search string constants across bytecode (LDC + String field ConstantValue)
and .properties resource keys/values. --regex, --ignore-case, --in /
--exclude, --limit. Properties hits render as prop path#key.
Graph & navigation upgrades
callersis override-aware by default (issue #6): includes call sites
through overrides and declaring supertypes;--exactopts out.
Constructors/static/private stay exact.callsstays bytecode-exact.usages --context N(issue #10): inline source window around each site
(capped at 15);0keepsfile:lineonly.- Bytecode ref edges carry
File.java:linewhen aLineNumberTableis
present (issue #8). samples --max-lines(issue #9): snippet cap is no longer hard-wired at 15.
Kotlin-true views
- File facades and multi-file parts expose Kotlin property / suspend /
@JvmNameviews instead of raw JVM projections (issue #12). - Nullability rendered from
@Metadata(issue #13). - Mismatch-detector blind spots closed (Companion
const, property removal)
(issue #14). - Kotlin PSI covers facade file-docs, enum entries with bodies, and
parameterised extensions (issue #15).
jdx setup: Windsurf + Aider (issues #38, #41)
The ninth and tenth backends — setup umbrella complete:
--agent |
Project scope | System scope | Version probe |
|---|---|---|---|
windsurf (aliases devin, …) |
.devin/mcp_config.json, walk-up |
~/.config/devin/mcp_config.json |
devin --version |
aider (aliases aiderdesk, …) |
.aider-desk/mcp-servers.json, walk-up |
$AIDER_DESK_HOME_DIR/mcp-servers.json else ~/.aider-desk/… |
aiderdesk --version |
Same merge discipline as the other eight: unrelated servers survive, re-runs
are byte-exact no-ops, --check reports without writing.
Also in setup/doctor: $HOME / $JDX_SETUP_HOME honouring (issue #85) and
single-line sanitized detected: probes (issue #84).
Windows installers (issue #92)
install-release.ps1— fetchjdx-<version>-windows.zip, unpack into
%LOCALAPPDATA%\Programs\jdx, write.jdx-release, add install dir to user
PATH.install.ps1— local-from-dist twin with ajdx.cmdforwarder into
%USERPROFILE%\.local\bin(no symlink / Developer Mode required).
Both stay ASCII-only for Windows PowerShell 5.1 (irm | iex).
Reliability / agent UX
- Launcher reads the real
java -versionline pastPicked up …option banners
(issue #88). - Warm daemon text re-colorizes on TTY (issue #17); plain on the wire unchanged.
- Warm exit 5 when the daemon cannot resolve coords is actionable (issue #18);
daemon statuslabelsindexed-artifacts 0as live-roots-first (issue #4). - Text warnings go to stderr with a per-code cap;
--jsonkeeps the envelope
warningsarray (issue #86). - Vineflower
$VFstubs treated as engine failures →javapfallback (issue #86). - Shell-expanded
--jars/--srcglobs exit 3 with a quote-the-glob hint
(issue #86). - Default
searchmiss hints--kind method(issue #86). - Uppercase package segments resolve for soak corpora (issue #1).
Known limitations
- Standing phase-2 backlog unchanged in kind: persistent-index acceleration
(#5), mappings/remap
(#24),--since
(#27), dataflow-lite
(#28), multi-release
variant selection beyond the warning
(#29). usages --kind throwremains declaration-level (throws), notATHROW
sites — as documented in v1.6.1.- Kotlin bodies still need the ~55 MB compiler sidecar
(#16).
Testing
- Release gate: full
./gradlew check -Pciplus per-OS distribution builds and
launcher smoke tests. - Fixture-corpus Test wiring centralized (issue #82); PIT javap-oracle fan-out
bounded (issue #81).
PRs in this release
| PR | What |
|---|---|
| #94 | Launcher reads java -version past JVM option banners (#88) |
| #95 | Sanitize multi-line version probes in detected: (#84) |
| #96 | Honour $HOME / JDX_SETUP_HOME for setup and doctor (#85) |
| #97 | Centralize fixture-corpus Test wiring (#82) |
| #98 | samples --max-lines (#9) |
| #99 | Windsurf / Devin Local setup (#38) |
| #100 | Aider / AiderDesk setup (#41) |
| #101 | Windows install-release.ps1 / install.ps1 (#92) |
| #102 | Hint --kind method on default search miss |
| #103 | Daemon status live-roots-first label (#4) |
| #104 | Quote hint for shell-expanded --jars/--src |
| #105 | Vineflower $VF stubs → engine failure / javap fallback |
| #106 | Text warnings to stderr with per-code cap |
| #107 | LineNumberTable file:line on bytecode ref edges (#8) |
| #108 | usages --context inline snippets (#10) |
| #109 | Kotlin nullability from @Metadata (#13) |
| #110 | Bound javap oracle / PIT threads under fan-out (#81) |
| #111 | Kotlin mismatch-detector blind spots (#14) |
| #112 | Re-colorize warm daemon text on TTY (#17) |
| #113 | Actionable warm exit-5 when daemon cannot resolve coords (#18) |
| #114 | Resolve uppercase package segments for soak (#1) |
| #115 | Override-aware callers with --exact opt-out (#6) |
| #116 | Kotlin-true file facades / multi-file parts (#12) |
| #117 | Kotlin PSI for facade docs, enum bodies, generic extensions (#15) |
| #118 | jdx literals string-constant search (#86) |
| #119 | jdx services SPI listing (#25) |
| #120 | jdx modules module-info listing (#25) |
| #121 | jdx manifest attributes (#25) |
| #122 | jdx resources path listing (#25) |
| #123 | jdx manifest --entries (#25) |
| #124 | jdx resources --cat (#25) |
| #125 | .properties keys/values in literals (#86) |
| #126 | usages --where annotation value predicates (#26) |
| #127 | Peel annotation-use spelling in usages (#26) |
| #128 | jdx annotated with recipe aliases (#26) |
| #129 | Nested-path / array-aware annotation --where (#26) |
| #130 | AnnotationValue AST + annotation-default merging (#26) |
Full Changelog: v1.6.1...v1.7.0