Fastest path to unstuck, by symptom:

• Troubleshooting - symptom-first decision tree
• Debugging - watch mode, raw streams, dev profile
• Install sanity - Node / npm / PATH checks
• Gateway troubleshooting - gateway-specific issues
• Doctor - apus doctor: health checks, config migrations, repair steps

FAQ

• FAQ - day-to-day concepts and operational questions
• First-run FAQ - install, onboard, auth, subscriptions, early failures
• Models FAQ - model selection, failover, auth profiles

Diagnostics

• Environment variables - where Apus loads env vars and precedence
• Diagnostics flags - runtime diagnostics and verbose modes
• Node and tsx startup errors - capture runtime versions and the stack trace for startup failures

Testing

• Testing - test suites and Docker runners
• Update and plugin tests - package update, migration, and plugin install validation
• Live tests - network-touching provider and CLI smokes
• Scripts - helper scripts under scripts/ and when to prefer the CLI

Community and meta

• Apus lore - the story
• Docs hubs - how this documentation is organized
• Docs directory - full file map