@nostale/cli

NoStale extracts knowledge from your codebase, indexes it, and generates PRD/TDD documents that stay in sync with every commit — no stale docs, no manual regeneration. Browse it from a web UI; ask it questions from the coding agent you already use, over MCP. This package is the installer CLI/TUI: it runs the setup wizard, supervises the wiki's services, and diagnoses a broken install.

Install

npm install -g @nostale/cli
nostale setup

No prior clone of the nostale repo is needed — the wizard walks you through personal mode (no Docker, local file DB) or server mode (full docker-compose stack), writes your config, runs migrations, and in personal mode provisions your first account automatically.

Commands

| Command | What it does | |---|---| | nostale setup | Interactive wizard — choose personal or server mode, configure the LLM provider, start everything | | nostale start | Start services (personal mode) or the docker compose stack (server mode) | | nostale stop | Stop services / the docker compose stack | | nostale status | Show what's running | | nostale config [subcommand] | Reconfigure an existing install — providers, templates, MCP tokens, sources, generation toggle | | nostale doctor | Diagnose a broken installation |

Personal vs. server mode

Personal mode runs the wiki as plain local processes (no Docker), storing data in a local libSQL file — the fastest way to try NoStale on your own machine. Server mode runs the full stack (including sqld) via Docker Compose, for a team sharing one wiki; images are pulled from GHCR, so it's zero-clone too. Either mode can be reconfigured later with nostale config, and nostale doctor helps diagnose whichever one you're running.

Learn more

• Repository, issues, and full documentation: github.com/fetot/nostale
• MCP integration, configuration reference, and FAQ: see the root README (a dedicated docs site is planned)

License

MIT