Repository navigation
Releases
Releases · XtrComSu/xt-forge
v0.4.5-Damascus — Ghidra MCP + Borer + Full REA Replacement
v0.4.5-Damascus — Ghidra MCP (38 Tools), Persistent Decompiler Overlay & Full REA Replacement
Highlights
- 38-Tool Ghidra & REA-Replacement MCP Server (
xt-forge mcp connect ghidra,python3 -m xtforge.adapters.ghidra_mcp):- Compatible with
LaurieWired/GhidraMCP,pyghidra-mcp, andrea-agentsworkflows (decompile_function,disassemble_function,procedure_pseudo_code,procedure_disassembly,binary_overview,xrefs_to,xrefs_from,get_call_graph,list_functions,list_imports,list_exports,list_segments,list_strings,list_classes,diff_binaries,unpack_asar,inspect_apk,inspect_netcap,analyze_javascript_application). - Tiered Execution: Routes across (1) live Ghidra GUI HTTP bridge (
GHIDRA_MCP_URL), (2) headless Ghidra (analyzeHeadless+ auto-detectedJAVA_HOME), and (3) instant<20 msborerlifter +.rodatastring & reciprocal-division math annotator. - Persistent Inline C Overlay (
$XT_HOME/re_overlay.db):rename_function,rename_variable,set_function_prototype, andset_decompiler_commentrewrite decompiled C signatures, variable names, call targets, and comments inline and allow subsequentdecompile_functioncalls by the renamed symbol. - Zero-Node.js REA Replacement: Automatically serves
reaMCP requests throughxtforge.adapters.ghidra_mcpwhenrea-agentsis not installed locally (orXT_REPLACE_REA=1).
- Compatible with
Install
curl -fsSL https://raw.githubusercontent.com/XtrComSu/xt-forge/main/install.sh | bashv0.4.4-Damascus — Borer MCP Integration & Clean Visual Cards
v0.4.4-Damascus
Borer MCP Integration & 1-Call Optimization (imjustprism/borer)
- First-class
borerMCP Preset & Trust Pinning:xt-forge mcp connect borerauto-detectsborer(BORER_CMD,PATH,~/.cargo/bin/borer,~/.local/bin/borer), scans all 34 MCP tools for prompt injection, pins the SHA-256 catalog digest in$XT_HOME/mcp_trust.json, and caches$XT_HOME/cache/mcp-catalog-borer.json. - 1-Call
load_binaryAuto-Injection & Session Persistence: Passing"path"or"binary"to any downstreamborer:*tool (decompile,function_summary,query,binary_info,strings,symbols,xrefs,cfg,callgraph) automatically executesload_binaryon the session and persists the active binary in$XT_HOME/cache/borer-session.jsonacross CLI and MCP calls. borer://Resource Discovery & Shorthand Normalization: Indexed all 39 static resources and 72 resource templates (triage,emulate,solve,taint,devirt,unpack,stackstrings,capabilities,antianalysis,dynimports,checks,yara) forxt_discoverand normalized shorthandquery(uri="capabilities")calls to"borer://capabilities".
Clean, Minimal 2x-Supersampled Visual Cards
- Redesigned
docs/assets/xt-oss-banner.png,docs/assets/xtforge-vs-rea-benchmark.png,docs/assets/architecture-rust-go.png, anddocs/assets/mcp-token-savings.pngwith generous negative space, crisp 2x-supersampled Noto Sans + JetBrains Mono typography, and a clean dark surface palette.
v0.4.3-Damascus
0.4.3 - 2026-11-19
Added
- Normalized Binary Diffing,
.rodataString Annotation & Reciprocal Division Decoding (xt-forge diff/re diff):- Added
xtforge.core.re.diff(diff_binaries), normalizing absolute/RIP-relative hex offsets acrossv1andv2binaries, annotatingfunction_disasm_v1andfunction_disasm_v2inline with resolved.rodatastring literals, and automatically decoding GCC/Clang strength-reduced reciprocal multiplication/shift constants (imul+sar/shr) into human-readable divisors and percentage shifts (diff_notes).
- Added
- Multi-File AST Static Correctness Auditor (
xt-forge audit/code audit):- Added
xtforge.core.code.audit(audit_workspace), detecting nested-loop duplicate aggregation without deduplication, asymmetric/off-by-one boundary comparisons (<vs<=), stale module caches where mutators omit invalidation, integer floor-division truncation in allocation helpers, and mutable defaults, with full line-numberedfunction_sourceandreader_sourceevidence.
- Added
- Cross-Module Active Dispatch Tracer (
xt-forge trace/code trace):- Added
xtforge.core.code.trace(trace_symbol), resolving runtime execution hops across package__init__.pyre-exports (from ... import ... as ...), duplicate symbol names, and JSON/YAML/TOML/INI/ENV/Python configuration dispatch tables (active_implementation,active_path,disputed_edges, andinactive_candidateswith line-numbered function excerpts).
- Added
- High-Concurrency Binary MapReduce & MCTS Hypothesis Solver (
xt-forge swarm):- Added
swarm mapandswarm mctsin the Go concurrency hub (native/xtforge-go/internal/swarm/engine.go) and Python fallback (xtforge/core/re/swarm.py).
- Added
- Top-Level Ergonomic CLI &
--metaGateway Shortcuts:- Added top-level aliases
xt-forge callers,xt-forge audit,xt-forge trace,xt-forge diff, andxt-forge context, plus first-class--metaMCP toolscode_callers,code_audit,code_trace, andre_diffwith zero-dash argument safety andevidence_completeflags in both Go (xtforge-hub) and Python (xtforge/adapters/mcp_server.py).
- Added top-level aliases
- 24
XTF-*Workflow Skills:- Added 6 new workflow skills (
XTF-CodeAudit,XTF-DispatchTrace,XTF-BinaryDiff,XTF-LSPNavigate,XTF-SwarmRE,XTF-SessionRecovery), expanding the catalog to 24 skills across Simple (8), Complex (8), and Advanced (8) tiers.
- Added 6 new workflow skills (
Fixed
- 6-Tier Live Benchmark (
scripts/bench_three_tier.py):- Extended the benchmark suite to 6 tiers (
tier1_find,tier2_fix,tier3_recover,tier4_defects,tier5_trace,tier6_regression_src,tier6_regression_bin) with live A/B pairing against raw REA (rea-agents, 229 tools) and fixedgrade_tier1so call-site grep lines inside fenced code blocks are not misclassified as definition bindings.
- Extended the benchmark suite to 6 tiers (
0.4.2 - 2026-11-18
XT-Forge v0.4.2-Damascus
XT-Forge v0.4.2-Damascus
Added
- Context-Miss Diagnostics & Unseen Generalization (
route context --diagnose):--diagnose,--expected-file, and--expected-lineacross Rust (xtforge-native) and Python (xtforge.core.route.pack) reportindexed,rank,score,drop_reason, and token cutoffs (20/20 hit rate oncontext_tasks.jsonvs3/20map baseline; 8/8 on held-outcontext_tasks_unseen.json).
- Live Evidence Freshness (
digest+ incremental cache invalidation):- Packed context slices include SHA-256
digestandstart_line..end_lineprovenance; live rename/move/delete edits invalidate affectedcode_graph.dbedges and cached slices without manual rebuilds (tests/test_context_freshness.py).
- Packed context slices include SHA-256
- Crash-Safe Tool Call Recovery & MCP Cancellation:
xtforge.core.call_journaland Gointernal/mcp/journal.gotrackpending/completed/unknownstates with request-scopednotifications/cancelledpropagation and dead-upstream session respawn (tests/test_call_recovery.py).
- Measured Discovery Cost & 3-Tier Live Harness Benchmarks:
scripts/bench_discovery_cost.py: Go--metastartup schema is1,384 B(346tok) and Python fallback is1,007 B(252tok) — direct MCP exposure wins 1-turn calls on tiny 4-tool catalogs, while--metasaves93.1%at 50 tools and98.5%at 229 tools.scripts/bench_three_tier.py(Find,Fix,Recover) +tests/test_shipped_packages.pycovering Python wheel (xtforge), npm (xt-forge,xtf), andinstall.sh.
Fixed
- Full RELRO Detection (
re checksec): InspectsDT_FLAGS(BIND_NOW) andDT_FLAGS_1(NOW) alongsideDT_BIND_NOWin both Go and Python (Fullon/bin/ls). - Bundled SQLite in Rust (
native/xtforge-rs/Cargo.toml): Enabledrusqlitebundledfeature so Rust builds cleanly without systemlibsqlite3-devheaders. codecCLI & Entropy Scanner: Fixed argparse intermixed option handling incodecCLI and eliminated false-positivehigh_entropyalerts on snake/kebab identifiers andexpected.jsonfixtures.- Version, Packaging & Proxy Accuracy: Aligned
0.4.2-Damascusversion metadata (serverInfoandclientInfo), fixeddoctornative_dirand engine reporting (caps.py), moved the MCP stdio implementation into wheel-includedxtforge/adapters/mcp_server.py, and forwarded customenvblocks frommcp_upstreams.json.
Verification
cargo test: 6 passed, 0 failed (xtforge-nativerelease built)go test -count=1 -race ./...: 4 packages ok (guard,intel,mcp,rehub; 4 packages have no tests) (xtforge-hubbuilt)python3 -m unittest discover -s tests -v: 509 tests OKnode --test plugins/xt-native/test/*.test.mjs: 17 passed, 0 failed
XT-Forge v0.4.1-Damascus
XT-Forge v0.4.1 — Damascus
Hybrid Rust + Go + stdlib Python local agent workbench for incremental symbol call graphs, offline binary reverse engineering, keyless CVE/IOC intel, prompt-injection & schema rug-pull auditing, and 0.90 KB MCP meta-routing.
Highlights in 0.4.1
- REA (
morluto/rea) & Craft Anything (storytold/craft-anything) MCP Support (mcp connect,mcp proxy --server,--meta):- Built-in presets and persistent stateful stdio sessions across multi-turn RE calls in both the Go hub (
xtforge-hub) and Python fallback (XT_FORCE_PYTHON=1), with automatic catalog refresh onnotifications/tools/list_changedandenable_toolset. - Run
xt-forge mcp connect rea --jsonorxt-forge mcp connect craft-anything --jsonto probe, scan for prompt injections, pin tool/catalog SHA-256 hashes inmcp_trust.json, and cache schemas for lazy<server>:<tool>routing viaxt-forge --meta.
- Built-in presets and persistent stateful stdio sessions across multi-turn RE calls in both the Go hub (
- Unified Cross-Runtime MCP Trust Pins: Python
xtforge.core.mcp_auditmatches Gointernal/mcp/audit.goSHA-256 schema/tool hashes so trust pins interoperate across engines. - Cross-Platform Installers & Agent Self-Install Prompts: Native Linux/macOS (
install.sh), Windows (install.ps1,bin/xtforge.cmd),npx xt-forge init, and copy-paste agent setup prompts inprompts/. - XT Visual Identity, Attribution & Clear Skill Names: Updated XT artwork (
docs/assets/xt-forge-icon.svg), standardizedXtrComSuauthorship across package metadata and history, and simplified all 18XTF-*workflow skill names (XTF-RepoMap,XTF-MCPGateway,XTF-Decompile, etc.).
Quick Install
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/XtrComSu/xt-forge/main/install.sh | bash
# Node / npx
npx -y xt-forge init# Windows PowerShell
irm https://raw.githubusercontent.com/XtrComSu/xt-forge/main/install.ps1 | iexRelease Assets
xt-forge-0.4.1-linux-x86_64.tar.gz— standalone Linux x86_64 bundle with compiledxtforge-native(Rust),xtforge-hub(Go),bin/,xtforge/,adapters/,skills/,prompts/, anddocs/.xt-forge-0.4.1.tgz— Node/npm CLI package (npx xt-forge init,xt-forge,xtf).xt_forge-0.4.1-py3-none-any.whl— stdlib-only Python wheel (pip/uv pip install).xt_forge-0.4.1.tar.gz— Python source distribution.SHA256SUMS— SHA-256 verification checksums (sha256sum -c SHA256SUMS).
XT-Forge v0.4.0-Damascus
XT-Forge 0.4.0 Release Notes (Preview)
Codename: Damascus
XT-Forge 0.4.0 expands the toolkit from a fast memory and file-routing CLI into a hybrid Rust + Go + Python workbench for agent steering, low-overhead MCP serving, and deterministic reverse engineering. Every new capability obeys the original contract: zero external Python runtime dependencies, strict path and command guards, structured --json output on every verb, and full fallback parity under XT_FORCE_PYTHON=1.
Highlights
- Four-tool MCP Meta-Gateway (
xt-forge --meta): Exposesxt_discover,xt_schema,xt_call, andxt_batchso agents can search and execute the full toolkit with a 0.90 KB compact schema footprint (94% smaller than the default 50-tool catalog) while leaving the default 50-tool surface untouched. - Dead-Simple CLI & Slash Integration (
npx xt-forge init,./install.sh,/xtf --meta): Putsxt-forgeandxtfdirectly ontoPATH, installs/xtfslash commands across DSH, OpenCode, and Claude Code, and syncs 18 3-tierXTF-*workflow skills automatically. - MCP Supply-Chain Security (
scan mcp,mcp audit,mcp trust,mcp proxy): Scans tool docstrings for hidden prompt injections, pins per-tool and catalog SHA-256 hashes inmcp_trust.json, detects silent post-install schema changes ("rug pulls"), and spills large responses cleanly tocache/artifacts/. - Persistent Code Call Graphs and LSP Bridge (
code index,code graph,code lsp,route context --symbols): Builds an incrementalcode_graph.dbacross Python, Rust, Go, JavaScript, TypeScript, and C/C++, connects callers and callees during context packing, and spawns local language servers on demand when available. - Stateful RE Workbench (
re annotate,asar,netcap,apk,decompile,trace): Hashes binaries by SHA-256 intore_overlay.db, merges analyst renames and comments directly into CFG/xrefs output, exports Radare2/Rizin and Ghidra scripts, inspects Electron ASAR and Android APK containers, summarizes HAR/SAZ captures with masked credentials, and adds Rust Mach-O headers and length-ranked XOR recovery. - Agent Steering & Negative Memory (
mem record-failure,mem consolidate,goal check,guard mode): Stores indexedfailed_attemptandanti_patternrecords, surfaces failure warnings during normal search, consolidates repetitive notes withderived_fromprovenance links, checks goals for criteria drift and scope bloat, and addsexplore | ask | autopermission modes with JSONL audit logs. - Parallel Research & Loop Daemon (
research,loop schedule | list | stop): Runs concurrent multi-store dossier queries and persists bounded recurring schedules (MaxTasks=50, 7-day lifetime,XT_NATIVE_LOOP=0kill switch).
Documentation & Visuals
- Field Guide
- Hybrid Rust, Go, and Python Architecture
- Reverse Engineering Workbench
- MCP Meta-Gateway and Steering
Preview Artifacts (Not Published)
Local build artifacts live in dist/ for hands-on inspection before any public release:
xt_forge-0.4.0-py3-none-any.whl: stdlib-only Python wheel (uv pip install xt_forge-0.4.0-py3-none-any.whl).xt_forge-0.4.0.tar.gz: Python source distribution.xt-forge-0.4.0-linux-x86_64.tar.gz: standalone Linux x86_64 preview bundle withbin/xtforge, compiledxtforge-native(Rust) andxtforge-hub(Go),xtforge/,adapters/, anddocs/.SHA256SUMS: artifact checksums ((cd dist && sha256sum -c SHA256SUMS)).