How to search and manage your project with the Claude Code plugin

This article covers how to search your uploaded project and manage what's in your search library. Before searching, make sure your project is set up - see How to Make Your Project Searchable with the Claude Code Plugin.


Ask a question

Run /ask-agent followed by your question:

/ask-agent where is authentication handled?
/ask-agent what are the pricing tiers in our contracts?

Returns an answer with source citations pointing to the relevant files. You can also use plain language without the slash command:

"search my codebase for rate limiting logic"
"what does my code say about error handling?"

Freshness warning: If the plugin warns that files have changed since the last upload, results may be incomplete. Run /rebuild-agent to re-sync before relying on the answer.


Check upload status

Run /check-status to see agent metadata, upload statistics, and index_status. Run after /create-agent or /rebuild-agent to confirm files are ready to search.


Browse uploaded files

Run /list-files to see all uploaded files with their IDs and status.


Remove a file

  1. Run /list-files to find the ID of the file you want to remove.
  2. Run /delete-page [file ID].

Delete the agent

Run /delete-agent to permanently delete the agent and remove .customgpt-meta.json. Asks for confirmation first.

📘

This is permanent.** To start fresh, run /create-agent again.


Related articles