XeCLI / Getting Started

Home

XeCLI Wiki

XeCLI is a terminal-first Xbox 360 RGH/JTAG toolkit for XBDM, JRPC2, FTP, XEX dumping, memory inspection, and automation. This wiki is the primary reference for the rgh CLI, bundled metadata, and release workflows.

The repository and product name are XeCLI. The installed terminal command is rgh.

Documentation Index

Getting Started

Page Purpose
Beginner Guide Safe first-run workflow: discovery, connect, status, and basic operations
Commands Reference Full command-by-command reference with examples
CLI Help Output Exact built-in rgh help output and top-level branch help screens
Hardware and System Controls Sign-in state, ring-light LEDs, fan commands, and SMC version notes
XNotify Notification usage, icon IDs, and direct integration notes
Troubleshooting Failure cases, common console/plugin issues, and recovery paths

Developer Reference

Page Purpose
Advanced Guide Reverse engineering, memory workflows, Ghidra flows, and automation usage
Frameworks and Internals Command architecture, transport layers, and internal design decisions
Documentation Standards Structure, conventions, and maintenance rules for this wiki
Contributing Contribution expectations for code, docs, validation, and release prep

Data and Integrations

Page Purpose
Integrations Reusing XeCLI from scripts and external tools
Title ID Database Bundled metadata files and how other tools can consume them
FAQ Short answers to repeated operator and developer questions

New operator path

  1. Beginner Guide
  2. Commands Reference
  3. Hardware and System Controls
  4. XNotify
  5. CLI Help Output
  6. Troubleshooting

Reverse-engineering path

  1. Advanced Guide
  2. Frameworks and Internals
  3. Commands Reference
  4. Title ID Database

Contributor path

  1. Contributing
  2. Documentation Standards
  3. Frameworks and Internals
  4. CLI Help Output

Capability Map

Console operations

  • Discovery, target persistence, and quick connection workflows
  • Status, title resolution, and profile visibility
  • Sign-in state, ring-of-light LED control, manual fan commands, and SMC version probing
  • Launch, reboot, and console notification workflows

Live inspection and debugging

  • Module list, info, dump, load, unload, and pending verification
  • Memory dump, hexdump, peek, poke, watch, strings, and search
  • Thread list, context, suspend, and resume
  • Debug stop/go, breakpoints, databreaks, and event watch

Storage and content

  • XBDM file-system operations
  • FTP-based browsing, transfer, and content discovery
  • Save extraction and injection
  • DashLaunch plugin slot management

Analysis and packaging

  • Running XEX dump and string extraction
  • Ghidra headless analysis and decompile export
  • ISO to Games on Demand conversion with watchdog mode
  • Bundled Title ID metadata for richer output and external tool reuse

Scope Boundaries

XeCLI is strong in live-console workflows. It does not currently claim to be:

  • a NAND flasher
  • a XeBuild replacement
  • a glitch-chip programmer
  • a full trace debugger

Current out-of-scope areas:

  • NAND read/write
  • image building or dashboard patching
  • glitch timing programming
  • trace/step debugging

Important Paths

Bundled assets

  • src/Xbox360.Remote.Cli/Assets/xbox360_gamelist.csv
  • src/Xbox360.Remote.Cli/Assets/xbox360_titleids.txt
  • src/Xbox360.Remote.Cli/ghidra_scripts/DecompileAllToC.java

Runtime state

  • %APPDATA%\XeCLI\config.json
  • %LOCALAPPDATA%\XeCLI\cache
  • %APPDATA%\XeCLI\titleids.local.csv

Common Starting Commands

rgh start
rgh ping
rgh status
rgh title
rgh modules list
rgh mem hexdump --addr 0x30000000 --size 0x40
rgh screenshot --out .\screen.bmp

Release and Docs Entry Points

Release Packaging

The published Windows release is a self-contained win-x64 package.

That means:

  • rgh.exe runs without a separate .NET install
  • runtime files ship beside the executable in the release folder
  • ConsoleDependencies/, Assets/, and ghidra_scripts/ ship in the same release package

Only source builds require a local .NET 10 SDK/runtime.