Skip to main content

​
Extension install (OAuth)

1

Install the extension from your shell

2

Log in from a Gemini CLI session

You’ll be redirected to Within in your browser to authenticate.

​
API key install

Use this for long-running background agents. Generate an API key from Settings → MCP in your Within workspace (see Authentication) and configure your Gemini CLI’s MCP block to send the Authorization: Bearer <YOUR_API_KEY> header for within.
Treat the API key like a password. Rotate it from Settings → MCP in Within if it’s exposed.

​
Verify

In a Gemini CLI session, ask:
The assistant should call search and return process results from your workspace.