Local Codebase Chat
The local-codebase application-state key is written by the Ask Plan browser
folder picker when a user links a local codebase. It includes the selected
folder name plus personal resource paths for the latest code index, file tree,
and captured source snapshots.
- The Ask Plan page can link a browser-selected local codebase folder. The UI
indexes safe text files, skips generated/secret-looking paths, writes a small
personal instruction resource under
instructions/local-codebases/, and stores captured file snapshots undercodebases/<id>/snapshots/<timestamp>/. - For live codebase questions, call
view-screenwhen context is unclear and inspectlocalCodebase. First read itsindexPathwith theresourcestool usingscope: "personal", then read relevant captured fileresourcePaths before making claims. Do not infer API contracts, schema shape, or UI behavior from file names alone. - If the file needed to answer is absent or skipped, ask the user to sync again or attach the file instead of guessing.
- For API/schema/UI visualization from a local codebase, call
get-plan-blocksorlist-plan-componentsbeforevisual-answer, then publish blocks such asopenapi-spec,api-endpoint,data-model,diagram,file-tree,tabs, andannotated-codegrounded in the files you read.
Related Skills
- visualize-repo — durable repo-backed visual documentation from local plan MDX files.
- plan-source-sync — reading and writing local plan folders.