DeepWiki
Use MCPorter deepwiki for public GitHub repository docs and codebase Q&A.
- NEVER assume native DeepWiki tools are mounted
- MUST run from the agent-config root
- MUST pass
--config assets/mcporter.jsonc - Missing
mcporter: MUST use the Nix fallback
nix run github:numtide/llm-agents.nix#mcporter --
Required follow-up reads
|Need|Read|When|
|---|---|---|
|Fallback contracts or broad tool/schema comparison|references/tools-schema.md|MUST read only after live discovery fails or broad comparison needs exact contracts|
Workflow
-
MUST discover live inventory first:
mcporter --config assets/mcporter.jsonc list deepwiki --brief -
MUST inspect selected tool's live schema:
mcporter --config assets/mcporter.jsonc list deepwiki.<tool> --schema -
Live success MUST override snapshot; NEVER infer absent response fields; NEVER load snapshots except for broad comparison.
-
Live failure MUST label snapshot use as fallback.
-
Routing:
- Repositories MUST use
owner/repo. ask_questionaccepts one or up to 10 repositories.- Other tools accept exactly one repository.
- Broad exploration SHOULD inspect structure before contents.
- Narrow questions SHOULD use
ask_question. - Multi-repository calls MUST use exact
--argsJSON.
- Repositories MUST use
-
Insufficient DeepWiki MAY switch to public-web research; MUST disclose.
read_wiki_contents can be large; MUST narrow first unless full docs are needed.
Scan to join WeChat group