# Introducing Sherlock: AI assistant for Depot docs (https://depot.dev/blog/introducing-ai-assistant-sherlock)

> By Pedro Guerra (Support Engineer at Depot), Andrea Anderson (Technical Writer at Depot)
> Published 2025-12-18

Our AI assistant for the [Depot docs](https://depot.dev/docs) is live! Sherlock gives you a new way to search and find answers exclusively in our documentation.

We built Sherlock for readers that prefer AI search to other ways of exploring content. You can use Sherlock to retrieve and assemble information for whatever you need at the moment.

## Adopting Sherlock

Sherlock’s name and image come from co-founder Kyle’s family pet and our company mascot, Sherlock the Corgi.

<figure className="text-center text-sm">
  <img src="/images/sherlock-sticker.webp" alt="Sherlock the Corgi sticker image" className="mx-auto w-auto max-w-sm" style="{border: 'none'}" />

  <figcaption>
    One of our coveted Sherlock stickers
  </figcaption>
</figure>

Sherlock the AI assistant is a Docs + Support + Co-Founder (thanks Jacob!) collaboration from our very first offsite back in October. Before the end of our one-day hackathon, we had a working chat bot for our docs. Like many proof of concept apps, only a few pieces remain in the production version. In Sherlock’s case, that’s the bulk of the system prompt.

If we’re being honest, we built Sherlock partly because we had a strong feeling that users *expect* to see an AI search option. But anecdotally we knew that some users *prefer* using AI to search a site. Any tool that helps users access the information they need to use Depot or to get unstuck is worth adopting.

We love how Sherlock can use key details from different docs to create a response that helps you get set up or solve a problem faster.

## How to use Sherlock

From the [Depot docs](https://depot.dev/docs), click **Ask AI** at the bottom right.

<ImageWithCaption src="/images/sherlock-main-page.webp" alt="Depot docs page with Ask AI button in bottom right corner" title="Find Sherlock on the docs site" className="mx-auto" />

Type your question in the chat modal.

<ImageWithCaption src="/images/sherlock-modal.webp" alt="Sherlock AI chat modal showing question input and response" title="Sherlock chat modal" className="mx-auto" />

Refine Sherlock’s response or explore further by asking follow-up questions. If you want to start a fresh Sherlock session, refresh your browser.

You also have the option to switch to Sherlock from regular search results. Click the banner to forward your query to Sherlock.

<ImageWithCaption src="/images/sherlock-search-banner.webp" alt="Banner offering to switch from search results to Sherlock AI assistant" title="Switch from regular search to working with Sherlock" className="mx-auto" />

## How Sherlock works

We built Sherlock using the [AI SDK](https://ai-sdk.dev/), with custom tools for the following:

* `list_pages`: list all documentation pages
* `grep`: search documentation with grep
* `read_page`: read the content of a specific docs page

The tools have direct access to the [markdown source](https://github.com/depot/docs) for our documentation site. This allows Sherlock to explore and understand the up-to-date documentation to answer questions. You can see Sherlock using those tools in real time as it compiles a response.

### Key features

* Reliable answers because Sherlock searches and formulates replies from only Depot content
* Links to the sources Sherlock used for the answer
* Concise, task-focused answers

## What we’re still working on

We’d love to build a completely customized docs experience, where readers can always successfully assemble and build docs exactly suited to their use case. But we also want to let users explore and learn on their own when they don't know what they need yet.

Both of these require a great set of docs as a foundation. We’re always working on that foundation: user-focused, deliberately-crafted documentation.

And of course, we’ll keep iterating Sherlock’s prompt and programming to make sure you’re getting the best possible answers.

## What’s next

Today Sherlock lives in our public documentation. Next, we want to make Sherlock available in the [Depot dashboard](https://depot.dev/orgs/), so you can have help with the right context, right where you need it.

We’d love to hear what you think about Sherlock or anything else in the Depot docs. Email us or join our Discord Community from our [help page](https://depot.dev/help).

## For AI Agents

The full site index is at [llms.txt](https://depot.dev/llms.txt). Append `.md` to any documentation, blog, changelog, or customer URL to fetch its markdown source directly.