Skip to content

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

Python

fix unreal insights skill mirror and repl history path

yuhaoe0eec1097184
diff --git a/skills/cli-anything-unrealinsights/SKILL.md b/skills/cli-anything-unrealinsights/SKILL.md
new file mode 100644
index 000000000..5986f7444
--- /dev/null
+++ b/skills/cli-anything-unrealinsights/SKILL.md
@@ -0,0 +1,131 @@
+---
+name: "cli-anything-unrealinsights"
+description: "Capture Unreal Engine traces to .utrace files and export Unreal Insights timing/counter data in headless mode."
+---
+
+# cli-anything-unrealinsights
+
+Use this CLI when you need agent-friendly access to Unreal Insights trace capture
+and exporter workflows on Windows.
+
+## Prerequisites
+
+- Unreal Engine 5.5+ installed with `UnrealInsights.exe`
+- Windows
+- Optional explicit env vars:
+ - `UNREALINSIGHTS_EXE`
+ - `UNREAL_TRACE_SERVER_EXE`
+ - `UNREALINSIGHTS_TRACE`
+
+## Core Commands
+
+### Backend discovery
+
+```powershell
+cli-anything-unrealinsights --json backend info
+```
+
+To use a source-built engine's matching `UnrealInsights.exe`:
+
+```powershell
+cli-anything-unrealinsights --json backend ensure-insights `
+ --engine-root 'D:\code\D5\d5render-ue5_3'
+```
+
+This first looks for `Engine\Binaries\Win64\UnrealInsights.exe` under the
+specified engine root, then builds it with that engine's `Build.bat` if needed.
+
+### Trace session state
+
+```powershell
+cli-anything-unrealinsights trace set D:\captures\session.utrace
+cli-anything-unrealinsights --json trace info
+```
+
+### Capture orchestration
+
+```powershell
+cli-anything-unrealinsights --json capture run `
+ --project 'D:\Projects\MyGame\MyGame.uproject' `
+ --engine-root 'D:\Program Files\Epic Games\UE_5.5' `
+ --output-trace D:\captures\boot.utrace `
+ --channels "default,bookmark" `
+ --exec-cmd "Trace.Bookmark BootStart" `
+ --wait --timeout 300
+```
+
+You can also keep using the explicit form:
+
+```powershell
+cli-anything-unrealinsights --json capture run `
+ 'D:\Program Files\Epic Games\UE_5.5\Engine\Binaries\Win64\UnrealEditor.exe' `
+ --target-arg 'D:\Projects\MyGame\MyGame.uproject'
+```
+
+### Continuous capture session control
+
+```powershell
+cli-anything-unrealinsights --json capture start `
+ --project 'D:\Projects\MyGame\MyGame.uproject' `
+ --engine-root 'D:\Program Files\Epic Games\UE_5.5' `
+ --output-trace D:\captures\live_session.utrace
+
+cli-anything-unrealinsights --json capture status
+cli-anything-unrealinsights --json capture snapshot D:\captures\live_snapshot.utrace
+cli-anything-unrealinsights --json capture stop
+```
+
+This is the preferred flow when an agent needs to start profiling now and stop
+or snapshot later in a follow-up turn.
+
+If a tracked capture session is still running, `capture start` now requires
+`--replace` so the previous process is stopped before a new one is launched.
+
+### Offline exporters
+
+```powershell
+cli-anything-unrealinsights --json -t D:\captures\session.utrace export threads D:\out\threads.csv
+cli-anything-unrealinsights --json -t D:\captures\session.utrace export timer-stats D:\out\stats.csv --region "EXPORT_CAPTURE"
+cli-anything-unrealinsights --json -t D:\captures\session.utrace export counter-values D:\out\counter_values.csv --counter "*"
+```
+
+### Batch response files
+
+```powershell
+cli-anything-unrealinsights --json -t D:\captures\session.utrace batch run-rsp D:\out\exports.rsp
+```
+
+## JSON Output Guidance
+
+- Prefer `--json` for agent workflows.
+- Export commands return:
+ - `trace_path`
+ - `exec_command`
+ - `output_files`
+ - `log_path`
+ - `exit_code`
+ - `warnings`
+ - `errors`
+ - `succeeded`
+- Capture returns:
+ - `command`
+ - `trace_path`
+ - `trace_exists`
+ - `trace_size`
+ - `pid` or `exit_code`
+- Continuous capture status returns:
+ - `pid`
+ - `running`
+ - `target_exe`
+ - `project_path`
+ - `trace_path`
+ - `trace_size`
+ - `started_at`
+
+## Notes
+
+- v1 is Windows-first.
+- v1 supports file-mode capture orchestration only.
+- v1 does not control already-running UE instances or browse trace stores.
+- `capture stop` is a best-effort stop of the harness-launched process tree.
+- `capture snapshot` is a best-effort filesystem snapshot of the active trace.
diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/core/session.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/core/session.py
index cf18c2e90..3685835eb 100644
--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/core/session.py
+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/core/session.py
@@ -16,7 +16,7 @@ def _normalize_path(path: str | None) -> str | None:
return str(Path(path).expanduser().resolve()) if path else None
-def _state_dir() -> Path:
+def state_dir() -> Path:
override = os.environ.get("CLI_ANYTHING_UNREALINSIGHTS_STATE_DIR", "").strip()
base = Path(override).expanduser() if override else Path.home() / ".cli-anything-unrealinsights"
base.mkdir(parents=True, exist_ok=True)
@@ -24,7 +24,7 @@ def _state_dir() -> Path:
def _state_file() -> Path:
- return _state_dir() / "session.json"
+ return state_dir() / "session.json"
@dataclass
diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.py
index 909b446d7..8c1852dbe 100644
--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.py
+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.py
@@ -22,7 +22,7 @@ from cli_anything.unrealinsights.core.capture import (
stop_capture,
)
from cli_anything.unrealinsights.core.export import execute_export, execute_response_file
-from cli_anything.unrealinsights.core.session import UnrealInsightsSession
+from cli_anything.unrealinsights.core.session import UnrealInsightsSession, state_dir
from cli_anything.unrealinsights.utils.errors import handle_error
from cli_anything.unrealinsights.utils.output import format_size, output_json
from cli_anything.unrealinsights.utils.unrealinsights_backend import (
@@ -666,7 +666,7 @@ def repl(ctx):
_repl_mode = True
session = _get_session(ctx)
- skin = ReplSkin("unrealinsights", version=__version__)
+ skin = ReplSkin("unrealinsights", version=__version__, history_file=str(state_dir() / "history"))
skin.print_banner()
pt_session = skin.create_prompt_session()