CLI

Last updated Jul 10, 2026 This guide walks you through creating an AI Search instance using the Wrangler CLI.

1. Install Wrangler

Install Wrangler, the command-line tool for Cloudflare Workers and developer platform products.

npmyarnpnpmbun

npm install wrangler

yarn install wrangler

pnpm install wrangler

bun install wrangler

2. Create an AI Search instance

Create a new instance.

wrangler ai-search create my-instance

You can upload files to the instance using the dashboard or the REST API.

Connect a data source (optional)

You can optionally connect a website or R2 bucket when creating the instance.

Website:

Automatically crawl and index a website that you own.

wrangler ai-search create my-instance --type web-crawler --source developers.cloudflare.com

R2 bucket:

Index documents stored in an R2 bucket.

wrangler ai-search create my-instance --type r2 --source my-bucket

3. Check indexing status

Check if your content has finished indexing by running the stats command.

wrangler ai-search stats my-instance

4. Test your instance

Once indexing is complete, run a search query against your instance.

wrangler ai-search search my-instance --query "What is Cloudflare?"

For the full list of available commands, refer to Wrangler commands.

Add to your application

Workers binding

Query AI Search directly from your Workers code.

REST API

Query AI Search using HTTP requests.

Was this helpful?

YesNo

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-search/get-started/wrangler/#page","headline":"CLI","description":"Create and manage AI Search instances from the command line.","url":"https://developers.cloudflare.com/ai-search/get-started/wrangler/","inLanguage":"en","image":"https://developers.cloudflare.com/ai-search/get-started/wrangler/og.png?v=ef9ce1b8708d04b7","dateModified":"2026-07-10","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Understand how AI Search indexes your content and retrieves results using vector and keyword search. title: How AI Search works image: https://developers.cloudflare.com/ai-search/concepts/how-ai-search-works/og.png?v=c4c7953b5003e839

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/ai-search/llms.txt
Use this file to discover all available pages before exploring further.

CLI

CLI