Core

Report CLI, license, and editor-bridge status

Reports three independent layers and never fails just because no editor is open: (1) the CLI itself, (2) your license status (active/trial/expired, email, expiry) read offline from the shared store, and (3) the editor bridge - best-effort probe of the editor this folder targets, with a clear next step (open the project or 'cfa launch') when none is connected. 'healthy' reflects CLI + license only. Run this first to verify your setup.

cfa health_check

Execute arbitrary Python code inside the running Unreal Editor

Runs Python code in the editor's Python environment where the 'unreal' module is pre-imported. Set a variable named 'result' to return structured data back. Use for operations not covered by other commands.

cfa execute_python --code "result = str(unreal.EditorAssetLibrary.list_assets('/Game'))"

Dump the C++ reflection-generated schema for reflected commands

Returns the JSON Schema generated from each reflection-backed command's C++ param USTRUCT (the single source of truth). With --name, returns one command's schema; otherwise returns every registered reflected command's schema. Used to keep the Go CLI specs in sync with the C++ structs (see the schema-drift test).

cfa dump_command_schema --name build_pcg_graph

List every running Unreal editor (pid, project, engine, port)

Lists all Unreal editors currently running with the plugin: their pid, project name, full .uproject path, engine path, engine version, and bridge port. Use this to see what is running before connecting. Each command you run targets exactly one editor; use connect_editor to choose which.

cfa list_editors

Select which running editor later commands talk to

Selects a running editor as the active target for subsequent commands (persisted, so it survives across separate terminals/processes). Choose by project name (e.g. --project jiggi, accepts 'jiggi' or 'jiggi.uproject') or by --port. Run list_editors first to see the choices. Use this when several editors are open, or when running from a folder that isn't inside the project.

cfa connect jiggi
  cfa connect_editor --project jiggi
  cfa connect_editor --port 55557

Clear the active editor selection

Clears the persisted editor selection set by connect_editor. After disconnecting, commands fall back to auto-detection (the current project's editor, or the single running editor) and refuse with a list when the choice is ambiguous.

cfa disconnect

Show the active selection and which editor commands would hit

Shows the running editors, the current selection (if any), the current-folder project, and which editor a command would connect to right now (with the reason), or why it would refuse. Use this to understand routing before running other commands.

cfa connection_status

Live facts about this editor and project in one read

Engine version, platform and RHI, project name, path, engine association and open map, the compile-time capabilities of this plugin build (profiling, 5.7+, 5.8+), enabled plugins (or a yes/no check of the names you pass), and the asset inventory by class under a content path. get_skill_context uses it to fill the bundled skill.

cfa get_project_context
  cfa get_project_context --plugins IKRig,Water --max-asset-classes 10

The bundled skill page with live facts from the running editor filled in

Reads one page of the bundled skill (SKILL.md or a reference page) and fills its {{tokens}} from the running editor in one round trip: engine version, project and open map, the plugins the page cares about, the commands unavailable on this engine version or without a plugin, the project's assets by class, and per-page extras such as the Niagara module list. With no editor running it returns the static page with the fallback text, and says why.

cfa get_skill_context
  cfa get_skill_context --page niagara

The substitution tokens the bundled skill uses and which pages carry them

Lists every {{token}} get_skill_context can fill, what each one means, the static fallback text skill install writes, and the pages that use it.

cfa list_skill_templates