What do you want to change?
Two doc bugs in the shipped docs.
-
models.md, providers.md, quickstart.md, custom-provider.md, SECURITY.md and scripts/smoke/README.md say models.json / auth.json / models-store.json live under ~/.stepcode/agent/. The CLI actually resolves them from the config root: apps/cli/src/main.ts passes modelsPath: join(resolveStepConfigRoot(), "models.json"), getStepAuthPath() returns join(resolveStepConfigRoot(), "auth.json"), and model-runtime.ts:180 puts models-store.json beside modelsPath. docs/step-unified-config-and-mcp.md already documents this move, the other pages were not updated with it.
-
step-integration.md says the built-in Step provider uses the anthropic-messages adapter and that startup "restores its anthropic-messages API". Source says the opposite: STEP_MODEL_API = "openai-completions" and normalizeStepModel repairs a stale overlay away from the legacy Anthropic dialect.
Why?
models.md is the documented way to add a custom model. Following it writes to a path the CLI never reads — that is exactly what happened to me: I created ~/.stepcode/agent/models.json first and it was silently ignored. The dialect paragraph describes the repair backwards, which misleads anyone debugging an endpoint problem.
How? (optional)
9 line-level edits across 7 files, docs only, no code changes. Prepared locally; happy to open a PR once approved with lgtm.
What do you want to change?
Two doc bugs in the shipped docs.
models.md,providers.md,quickstart.md,custom-provider.md,SECURITY.mdandscripts/smoke/README.mdsaymodels.json/auth.json/models-store.jsonlive under~/.stepcode/agent/. The CLI actually resolves them from the config root:apps/cli/src/main.tspassesmodelsPath: join(resolveStepConfigRoot(), "models.json"),getStepAuthPath()returnsjoin(resolveStepConfigRoot(), "auth.json"), andmodel-runtime.ts:180putsmodels-store.jsonbesidemodelsPath.docs/step-unified-config-and-mcp.mdalready documents this move, the other pages were not updated with it.step-integration.mdsays the built-in Step provider uses theanthropic-messagesadapter and that startup "restores itsanthropic-messagesAPI". Source says the opposite:STEP_MODEL_API = "openai-completions"andnormalizeStepModelrepairs a stale overlay away from the legacy Anthropic dialect.Why?
models.mdis the documented way to add a custom model. Following it writes to a path the CLI never reads — that is exactly what happened to me: I created~/.stepcode/agent/models.jsonfirst and it was silently ignored. The dialect paragraph describes the repair backwards, which misleads anyone debugging an endpoint problem.How? (optional)
9 line-level edits across 7 files, docs only, no code changes. Prepared locally; happy to open a PR once approved with
lgtm.