One page per part of the program. Every module, script, data file, and test
suite has a page here. If you edit a file, refresh its page — the
../READ_1ST_CHANGES.txt map at the repo root tells you which.
| Part | File | Covers |
|---|---|---|
| Architecture | overview.md | module map, session flow, design decisions |
| Entry points & launchers | entrypoints.md | __main__.py, __init__.py, g023.sh, g023.bat |
| REPL / dashboard | cli.md | g023_code/cli.py — the CLI class, main loop, slash handlers |
| Slash command catalogue | commands.md | g023_code/commands.py — the Command data |
| Agent loop | orchestrator.md | g023_code/orchestrator.py |
| DeepSeek API client | api.md | g023_code/api.py |
| Configuration | config.md | g023_code/config.py — paths, settings, scopes |
| Ollama client | ollama_client.md | g023_code/ollama_client.py |
| OpenRouter client | openrouter_client.md | g023_code/openrouter_client.py |
| SQLite cache | cache.md | g023_code/cache.py |
| Usage & pricing | usage.md | g023_code/usage.py + ds_pricing.json |
| Drift signals | signals.md | g023_code/signals.py |
| Surge pricing | surge.md | g023_code/surge.py + ds_times.json |
| Terminal UI | ui.md | g023_code/ui.py |
| Web fetching | web_fetch.md | g023_code/web_fetch.py |
| Input prompt | prompt.md | g023_code/prompt.py |
| Tools | tools.md | g023_code/tools/registry.py, tools/schemas.py |
| Subagents | subagents.md | g023_code/subagents/* |
| Tests | tests.md | tests/ |
| Installers | installers.md | installer.sh, installer.bat, requirements.txt |
| Data files | data_files.md | K.dat, OK.dat, config.json, OR_VISION.json, ds_*.json |
Not documented here: media/ (has its own media/README.md) and
releases/ (packed archives).