菜单
One-page repo layout. Use to locate files without globbing. First skill to invoke after pick-task.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Quick reference for src/vramgeist/calc.py — formulas, public functions, gotchas. Use before editing calc.py.
Keep input small. Use before any Read or Grep call when context budget tight.
Quick reference for src/vramgeist/gguf.py parser. Use before editing gguf.py or adding new metadata keys.
Pick next unfinished task from TASK_BOARD.md. Use at start of every session and after finishing one task.
Required end-of-response format. Use before submitting any response that edited files.
Break a Tier 3 (🔴) task into 3-5 Tier-2-shaped sub-tasks before editing. Use whenever picked task is Tier 3.
| name | repo-map |
| description | One-page repo layout. Use to locate files without globbing. First skill to invoke after pick-task. |
src/vramgeist/
__main__.py entry: python -m vramgeist
cli.py argparse + orchestration; lazy imports config_persist + tui
config.py VRAMConfig dataclass, DEFAULT_CONFIG, profile presets
config_persist.py load/save user config (lazy imported)
hw.py GPU/RAM detect: nvidia-smi, AMD, Intel, Apple, dxdiag
gguf.py GGUF binary parser (see gguf-quickref)
calc.py VRAM/RAM/TPS math, ctx picker (see calc-quickref)
ui.py Rich Live UI, tables
validate.py runtime validation feature
_rich_fallback.py shim when rich missing
bench/
llama_bench.py optional TPS bench via llama-cpp-python or subprocess
tui/
file_browser.py Textual interactive picker
tests/
test_calc*.py calc.py
test_gguf*.py gguf.py
test_hw*.py hw.py
test_cli*.py cli.py
test_main.py __main__ + smoke
test_bench*.py bench
test_llama_bench.py
test_rich_fallback*.py
| File | Use |
|---|---|
CLAUDE.md | project rules, commands |
GEMMA_WORK_RULES.md | operating rules for local models |
TASK_BOARD.md | work queue |
PROJECT_STATE.md | what currently works |
ARCHITECTURE.md | deeper design notes |
vramgeist → vramgeist.cli:mainpython -m vramgeist → __main__.py → cli.main()config_persist and tui.file_browser imported INSIDE main() to keep CLI start fast. Preserve laziness when editing.