Menu
One-page repo layout. Use to locate files without globbing. First skill to invoke after pick-task.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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.