Cheat Engine CLI Skill

Turn process-memory debugging into a repeatable command—not a fragile sequence of clicks.

English · 简体中文 · Get Cheat Engine CLI

Important

This is an independent agent skill for the independent cecli project. It is not an official Cheat Engine product. Use it only with processes, applications, games, systems, and endpoints you own or are explicitly authorized to inspect.

Give Your Agent a Memory Workflow

The Cheat Engine CLI Skill teaches coding agents how to choose the correct local or remote transport, discover a process, map readable memory, perform typed reads, run bounded exact scans, and preview guarded writes with cecli.

Instead of handing an agent a powerful binary and hoping it improvises safely, this skill gives it a disciplined sequence:

authorize → discover → map → read → scan → preview → confirm → verify → restore

Why This Skill

• macOS and Windows native guidance — use cecli --native for eligible processes on the same operating system.
• Remote ceserver workflows — connect to authorized Linux, Android, VM, or lab targets with --endpoint.
• JSON-first automation — treat stdout as data, stderr as diagnostics, and exit codes as the source of truth.
• Exact, bounded scans — select data types, address ranges, protections, alignment, and result limits.
• Writes that fail closed — read first, preview with --dry-run, request fresh confirmation, then execute with --yes --verify.
• Bilingual guidance — English and Simplified Chinese references ship together.
• Honest boundaries — no multiplayer cheating, anti-cheat bypass, credential extraction, stealth, or unauthorized process access.

Install

Install with the Skills CLI:

npx skills add chengyixu/cheat-engine-cli-skill@cheat-engine-cli -g -y --agent codex

Replace codex with another supported agent identifier when needed. Or clone the repository and copy skills/cheat-engine-cli into the skills directory used by the agent platform.

The companion CLI is installed separately:

git clone https://github.com/chengyixu/cheat-engine-cli.git
cd cheat-engine-cli
make build
./bin/cecli self-check

Invoke

Use $cheat-engine-cli to inspect my authorized local game process on macOS,
find its PID, map writable memory, and build a read-only exact-value scan.

Use $cheat-engine-cli to preview changing this owned test process value.
Do not write until I approve the exact PID, address, old value, and new bytes.

使用 $cheat-engine-cli 连接我已授权的 ceserver，查找目标进程，
先读取和扫描，不要在我确认前执行任何写入。

What the Skill Teaches

Workflow	Guidance
Target selection	Choose exactly one of --native or --endpoint
Process discovery	Verify process name, PID, architecture, and transport
Memory mapping	Enumerate regions before reading or scanning
Typed reads	Decode integers, floats, strings, and raw bytes
Exact scans	Search typed values or wildcard byte patterns within explicit bounds
Safe writes	Preserve the old value, dry-run, confirm, execute once, verify, offer restore
Failure handling	Interpret structured errors and stop on verification conflicts
Platform constraints	Respect macOS signing/SIP and Windows integrity boundaries

Repository Layout

skills/cheat-engine-cli/
├── SKILL.md
├── agents/openai.yaml
└── references/
    ├── getting-started.md
    ├── getting-started.zh-CN.md
    ├── workflows.md
    ├── workflows.zh-CN.md
    ├── safety.md
    └── safety.zh-CN.md

Search and Discovery

This skill is designed for queries such as:

• Cheat Engine CLI skill
• automate Cheat Engine from terminal
• command-line process memory scanner
• ceserver client for AI agents
• macOS process memory CLI
• Windows process memory scan command
• 命令行扫描进程内存
• Cheat Engine 命令行工具
• macOS / Windows 内存读取与修改

Safety Contract

The skill requires authorization and treats memory writes, debugger controls, injection, termination, thread controls, protection changes, remote file changes, and similar operations as destructive. Every executable write requires fresh explicit confirmation; reusable examples remain read-only or use --dry-run.

See the English safety boundary or 简体中文安全边界.

Companion Project

This skill is the agent playbook for chengyixu/cheat-engine-cli, the JSON-first CLI that provides native macOS/Windows process-memory access and remote Cheat Engine ceserver compatibility.

Validate

python3 scripts/validate.py

Validation checks metadata, bilingual documents, reciprocal links, reference integrity, and unsafe executable examples.

The repository also ships bilingual trigger and safety evaluation cases under tests/ so future wording changes do not silently weaken invocation coverage or destructive-operation boundaries.

License

The original skill content in this repository is available under the MIT License. Cheat Engine and the companion CLI have separate notices and licensing conditions; review the companion project's NOTICE.md before redistribution.

Security and responsible-use reporting guidance is in SECURITY.md.