kumiko doctor
kumiko doctorWalks through a checklist and prints ✓ or ✗ for each item, with an
actionable hint when something is missing.
What it checks
Section titled “What it checks”| Check | Hint when failing |
|---|---|
.env file exists | cp .env.example .env |
| Required env vars set | shows the missing names |
node_modules/ exists | bun install |
| Docker services running | kumiko dev |
| Postgres accepts connections | docker compose logs postgres |
Required env vars currently include DATABASE_URL, TEST_DATABASE_URL,
REDIS_URL, MEILI_URL, MEILI_MASTER_KEY, JWT_SECRET.
When to use
Section titled “When to use”- After cloning the repo, before doing anything else
- When something behaves weirdly and you want to rule out env drift
- Before reporting a bug — paste the doctor output
Exit code
Section titled “Exit code”0 when everything is green. 1 when at least one check failed — useful
in CI sanity-check jobs or pre-task scripts.
See also
Section titled “See also”kumiko dev— boot services if doctor says they’re downkumiko status— services + git, lighter than doctor