ComfyUI-Lora-Manager/.agents/skills/lora-manager-runtime-context/SKILL.md

name, description

name	description
lora-manager-runtime-context	Inspect ComfyUI LoRA Manager runtime configuration and local diagnostic state. Use when debugging LoRA Manager issues that require locating or reading settings.json, active library paths, model metadata JSON sidecars, recipe metadata JSON files, example image folders, SQLite caches, symlink maps, download history, aria2 state, or other cache files under the LoRA Manager user config directory.

LoRA Manager Runtime Context

Core Rules

• Treat runtime state as local user data. Prefer read-only inspection unless the user explicitly asks for mutation.
• Never print secret-like settings values. Redact keys containing key, token, secret, password, auth, or credential, including civitai_api_key.
• Resolve paths from the runtime configuration before guessing. Settings-directory precedence (highest first):
  1. Explicit override — env LORA_MANAGER_SETTINGS_DIR or standalone --settings-path (also accepted by the inspect script as --settings-path DIR). Pins EVERYTHING (settings.json, cache/, wildcards/, backups/, logs/, stats/) under the given directory; bypasses portable mode and the user config dir. Common when inspecting a sandboxed/E2E instance.
  2. Portable — repository <repo-root>/settings.json with "use_portable_settings": true (or LORA_MANAGER_PORTABLE=1): settings dir = <repo-root>.
  3. Default — ~/.config/ComfyUI-LoRA-Manager on this machine (platformdirs.user_config_dir("ComfyUI-LoRA-Manager", appauthor=False)).
• Use the active library when selecting per-library caches and paths. Read active_library from settings; fall back to default if missing.
• Normalize and expand ~ before comparing paths. Symlinks are common in this repo.

Quick Start

Use the bundled helper for a safe first pass:

python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py summary
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py caches

The script redacts sensitive settings, opens SQLite databases read-only, and reports inaccessible or locked databases as warnings.

For focused checks:

python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py recipes
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py model --path /path/to/model.safetensors
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py sqlite --db /path/to/cache.sqlite --limit 3

To inspect a sandboxed/E2E instance that pins its settings directory:

# --settings-path DIR (or LORA_MANAGER_SETTINGS_DIR) works with every subcommand:
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py \
  --settings-path /tmp/opencode/<plan>-e2e/settings summary

Runtime Path Rules

• Settings directory: resolve via py/utils/settings_paths.py — get_settings_dir() honors the LORA_MANAGER_SETTINGS_DIR / programmatic override first, then portable mode, then platformdirs.user_config_dir("ComfyUI-LoRA-Manager", appauthor=False). The inspect script mirrors this precedence in resolve_settings_path().
• Settings file: <settings_dir>/settings.json.
• Cache root: <settings_dir>/cache.
• Canonical cache files:
  • Model cache: cache/model/<active_library>.sqlite.
  • Recipe cache: cache/recipe/<active_library>.sqlite.
  • Model update cache: cache/model_update/<active_library>.sqlite.
  • Recipe FTS: cache/fts/recipe_fts.sqlite.
  • Tag FTS: cache/fts/tag_fts.sqlite.
  • Symlink map: cache/symlink/symlink_map.json.
  • Download history: cache/download_history/downloaded_versions.sqlite.
  • aria2 state: cache/aria2/downloads.json.
• Legacy cache locations may exist; prefer canonical paths unless diagnosing migrations.

Data Location Rules

• Model roots come from settings.folder_paths and the active library payload under settings.libraries[active_library].
• Model metadata JSON sidecars live next to the model file as <model basename>.metadata.json.
• Recipes root is settings.recipes_path when it is a non-empty string. If empty, use the first configured LoRA root plus /recipes.
• Recipe JSON files are named *.recipe.json under the recipes root and may be nested in folders.
• Example image root is settings.example_images_path.
• If multiple libraries are configured, example images are stored under <example_images_path>/<sanitized_library>/<sha256>/; otherwise they are under <example_images_path>/<sha256>/.

Useful Cache Tables

• Model cache: models, model_tags, hash_index, excluded_models.
• Recipe cache: recipes, cache_metadata.
• Model update cache: model_update_status, model_update_versions.
• Tag FTS cache: tags, fts_metadata, plus FTS internal tables.
• Recipe FTS cache: recipe_rowid, fts_metadata, plus FTS internal tables.
• Download history: downloaded_model_versions.

Prefer querying only counts, schema, and a few sample rows unless the user asks for full output.