@cheatron/cli

Cheatron CLI is a lightweight, command-line interface for the Cheatron ecosystem. It allows you to perform advanced process manipulation, DLL injection, and target management without the need for a full GUI.

Built on top of @cheatron/core and @cheatron/native, it provides a fast and scriptable way to interact with Windows x64 processes.

Features

• Process Enumeration: Quickly find and select target processes with visible windows.
• DLL Injection: Inject one or more DLLs into a target process using advanced thread hijacking.
• Thread Management: List and select specific threads for hijacking or monitoring.
• Module Inspection: View loaded modules and their base addresses in the target process.
• Persistent State: Remembers your selected target across sessions (stored in ~/.cheatron-cli.json).

Installation

# Install globally via npm/bun
npm install -g @cheatron/cli
# or
bun add -g @cheatron/cli

Usage

1. Find and Select a Target

List all active processes with windows:

cheatron targets

Select a target by PID or name:

cheatron targets 1234
# or
cheatron targets "Notepad"

2. Inject a DLL

Inject a DLL into the currently selected target:

cheatron inject C:\path\to\your.dll

You can also specify a specific Thread ID (TID) to hijack:

cheatron inject C:\path\to\your.dll --tid 5678

3. Manage Targets

View current target info:

cheatron target info

List modules in the target:

cheatron target modules

List threads in the target:

cheatron target threads

Development

Prerequisites

• Bun (recommended)
• Windows x64 (for native features)

Setup

git clone https://github.com/Cheatron/cheatron-cli.git
cd cheatron-cli
bun install

Build & Test

# Build the project
bun run build

# Run tests
bun run test

# Linting
bun run lint

License

MIT © Cheatron