Implement basic URL scheme for Assistant & AI Search

[zenoachtig]

• Reshapes the query parameters previously used for Search & Ask AI to work for all three: search, AI Search, and AI Assistant.
• ?q= always dictates the search state
• ?ask= always dictates the AI Search / AI Assistant state.
• You can switch between the two.
• Both parameters now accept a string. When they are present in the URL without a string, the respective component is opened on the blank state. When there is a string present, it's used to pre-fill.
• Added a rewrite for legacy URLs q=query&ask=true → ask=query&q=null

[linear]

RND-7715 Basic URL scheme

[changeset-bot]

🦋 Changeset detected

Latest commit: 0c09e49

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
gitbook	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-amn0yxkh6-gitbook.vercel.app	✅
Cloudflare	https://55dc675b-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-amn0yxkh6-gitbook.vercel.app/url/gitbook.com/docs	https://55dc675b-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-amn0yxkh6-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://55dc675b-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2 (Inspect)	✅ No changes detected	-	Jul 29, 2025, 1:32 PM
v2-cloudflare (Inspect)	👍 Changes approved	16 added, 8 removed	Jul 29, 2025, 1:37 PM
v2-vercel (Inspect)	👍 Changes approved	16 added, 8 removed	Jul 29, 2025, 1:33 PM

[taranvohra]

Code looks good to me. Maybe we should add couple more E2E tests for the behavior. for ex - type in search bar -> click Assistant icon -> should open the AI chat etc

[zenoachtig]

Code looks good to me. Maybe we should add couple more E2E tests for the behavior. for ex - type in search bar -> click Assistant icon -> should open the AI chat etc

Thanks Taran, I added a bunch of tests now 😄