setup

/setup

Guides you through ΩmegaWiki's optional API key configuration. Reads your current .env, shows what is and isn't configured, and helps you set up each key with clear explanations of what it does and how to get it. Safe to re-run at any time — only updates keys you choose to configure.

Inputs

• No arguments required
• Reads: .env (current configuration state)
• Reads: config/setup-guide.md (reference for what each key does)

Outputs

• Updated .env with any newly configured keys
• A summary of current configuration status

Wiki Interaction

Reads

• None (setup runs before any wiki exists)

Writes

• None (does not touch the wiki)

Workflow

Step 1: Read Configuration Reference

Read config/setup-guide.md to load the complete reference for all configurable keys, including what each does, which skills use it, how to get it, and fallback behavior.

Step 2: Detect Current Environment

Run the following to check what is already configured:

python3 -c "
import sys, os
sys.path.insert(0, 'tools')
try:
    import _env
except Exception:
    pass
keys = {
    'SEMANTIC_SCHOLAR_API_KEY': 'Semantic Scholar',
    'DEEPXIV_TOKEN':            'DeepXiv',
    'LLM_API_KEY':              'Review LLM (API key)',
    'LLM_BASE_URL':             'Review LLM (base URL)',
    'LLM_MODEL':                'Review LLM (model)',
}
for k, label in keys.items():
    v = os.environ.get(k, '').strip()
    print(f'SET:{k}' if v else f'UNSET:{k}')
"

Also detect the Python environment and .venv status:

ls .venv/ 2>/dev/null && echo "venv:present" || echo "venv:absent"
python3 --version

Step 3: Show Configuration Status

Present a clear summary to the user, grouped by status:

ΩmegaWiki Configuration Status
================================
✓  ANTHROPIC_API_KEY      — managed by Claude Code (claude login)

Recommended:
✗  Semantic Scholar        — not set  (citation expansion 3x slower — get free key)

Optional:
✗  DeepXiv                 — not set  (semantic search unavailable)
✗  Review LLM              — not set  (cross-model review unavailable)