docs: karpathy-pattern wiki built from the spec, plan, design contract and decisions ledger
kb/ is its own wiki root: 34 pages across 7 categories, index.md catalog, log.md, AGENTS.md schema layer, and raw/ holding copies of README, the spec, the 13-task plan, the design master and the SDD ledger. Every page cross-references 3 to 6 others and all 107 wikilinks resolve except two [["list"]] artefacts inside JSON snippets in the copied plan. Kept separate from the repository root on purpose: its generated graph lands in kb/.ua/ instead of overwriting the code graph. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.7
parent
735a57bfd6
commit
8b42a0931c
@@ -0,0 +1,16 @@
|
||||
# Running locally
|
||||
|
||||
`npm install && npm run build && npm start` serves the production build on port 3000. `npm run dev` works too, but
|
||||
cookie flags and hydration differ from production, which is why the end-to-end suite exists.
|
||||
|
||||
Two environment values matter: `APP_SECRET` (at least 16 characters, seals stored keys — changing it makes them
|
||||
unreadable and the app asks for them again) and `DATA_DIR` (where `qai.db` lives, default `./data`).
|
||||
`.env.example` documents both plus `COOKIE_SECURE`.
|
||||
|
||||
Model credentials are not environment configuration. They belong to each user and are pasted into the settings
|
||||
screen.
|
||||
|
||||
One operational trap worth knowing: deleting the data directory while a server is running leaves that server
|
||||
writing into an unlinked inode. The app keeps answering and the database no longer exists anywhere.
|
||||
|
||||
Related: [[Environment variables]], [[Container plan]], [[Gitea remote]].
|
||||
Reference in New Issue
Block a user