Feature request: Comprehensive Documentation for Built-in AI Agent Tools

[lem0n4id]

Currently, there doesn’t appear to be a single dedicated page or comprehensive documentation covering the built-in AI agent tools contributed by VS Code.

Examples of such tools include:

• insert_edit_into_file
• read_file
• file_search
• semantic_search
• create_file
• replace_string_in_file
• fetch_webpage
• vscode_search_extensions_internal
• getCurrentMilestone
• getReleaseFeatures

These are mentioned in a scattered fashion across posts and examples (e.g., when explaining *.prompt.md usage), but there’s no central reference describing their purpose, parameters, and usage guidelines.

This makes it difficult for developers experimenting with agent mode to fully understand the toolset and its intended usage.

Feature Request

• Provide a dedicated documentation page (or section) listing all built-in tools contributed by VS Code.
• Include at minimum:
  • Tool name
  • Purpose/description
  • Example usage
  • Notes on availability/limitations

Reference

A related community discussion highlighting the confusion:
Reddit thread

This would help both new and advanced users take full advantage of the built-in agent capabilities.

[lem0n4id]

Any update on this?

[lem0n4id]

Any update on this? @roblourens

[lem0n4id]

@kieferrm can you take a look at this?

[vs-code-engineering]

We closed this issue because we don't plan to address it in the foreseeable future. If you disagree and feel that this issue is crucial: we are happy to listen and to reconsider.

If you wonder what we are up to, please see our roadmap and issue reporting guidelines.

Thanks for your understanding, and happy coding!

[roblourens]

The tools have descriptions good enough for LLMs to understand it at least 😄 happy to answer specific questions