René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Fresh install has no settings.json: first run fails with \"API key not found\" and forces manual file creation","articleBody":"## Summary\n\nOn a fresh install, deepcode never creates `~/.deepcode/settings.json`. The directory is created (it holds `machine-id`, `projects/`, etc.), but there is no settings file. The first task therefore fails with:\n\n```\n✦ API key not found. Please configure ~/.deepcode/settings.json or ./.deepcode/settings.json.\n```\n\nThe error tells the user to \"configure\" the file, but the file does not exist and the user has to create it from scratch while guessing the schema (`env.API_KEY`, `env.BASE_URL`, `env.MODEL`).\n\n## Steps to reproduce\n\n1. `npm i -g @vegamo/deepcode-cli` on a machine with no prior config.\n2. Run `deepcode` and send any prompt.\n3. Observe the `API key not found` error.\n4. `ls ~/.deepcode/` — there is no `settings.json` to edit.\n\n## Expected\n\nFirst run should produce a ready-to-edit `~/.deepcode/settings.json` template (empty `API_KEY`, default `BASE_URL`/`MODEL`) so the user only has to paste their key, rather than authoring the file and its schema by hand.\n\n## Environment\n\n- Package: `@vegamo/deepcode-cli`\n- Version: 0.1.31 (also reproduces on current `main` / 0.1.33)\n- OS: macOS (darwin)\n\n## Notes\n\nRoot cause is in `packages/core/src/settings.ts`: settings are only ever *read* on startup (`readSettings()` returns `null` when the file is missing) and only *written* lazily when something like a model selection changes. Nothing scaffolds the file on first run.\n\nI have a fix ready (auto-scaffold a template on first run, never overwriting an existing file) and will open a PR referencing this issue.","author":{"url":"https://github.com/kuishou68","@type":"Person","name":"kuishou68"},"datePublished":"2026-06-26T11:32:08.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/202/deepcode-cli/issues/202"}