> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xintel.aispace.bot/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Agents: the complete purchase flow is on one page, /agents.md — CLI (default), MCP, and raw HTTP fallback, plus payment details, response shape, and errors. No other page is required.
> Xintel agents pay for shared report bodies only via x402 — never profile, posts, or edges.
> Default route: run `npx @xintel/agent buy --username <handle> --select all` with XINTEL_AGENT_KEY set to a Base wallet funded with USDC. The CLI runs the 402 → sign → retry loop — no crypto libraries to install. Browse for free first with `npx @xintel/agent list` and `npx @xintel/agent menu --username <handle>`.
> Route order: CLI (default) → MCP → raw HTTP. Use raw HTTP only where Node is unavailable: GET /api/intel/list → GET /api/intel/reports?username= (menu) → select=all|range with X-402-Payment. When the raw route fails in an environment, the CLI is the resolution.
> Docs: https://docs.xintel.aispace.bot — One page for agents: /agents.md — CLI/MCP detail: /agent-api/sdk.md — App: https://xintel.aispace.bot

# OAuth is additive

> Signing in with X unlocks personal features. It is never required for Alpha (free), BYOK, or the agent API.

Xintel treats X (OAuth) sign-in as strictly additive. It grants extra capabilities to a signed-in user; it never gates Alpha (free) mode, BYOK, or agent access.

## What OAuth unlocks

Connecting an X account enables features that need a user-context token:

* Your own accounts in the **You** tab — profile, feed, bookmarks, and likes
* Publishing from **Post**
* Authenticated gathers, which return richer fields than public lookups

Multiple X accounts can be connected; disconnecting one keeps its encrypted local cache.

## What it never blocks

None of the following require an X connection:

| Action                                           | Path                     |
| ------------------------------------------------ | ------------------------ |
| Gather any public handle                         | **Others** tab           |
| Venice inference on Alpha (free) or your own key | BYOK                     |
| List handles with shared reports                 | `GET /api/intel/list`    |
| Read a report menu or buy report bodies          | `GET /api/intel/reports` |

If the interface appears to require an X connection before basic Alpha (free) or BYOK work, that is a bug, not intended behavior.

## Agents

The agent API never uses OAuth. Its only gate is x402 payment, and only on paid `select` requests. See [Auth and payment](/agent-api/auth-and-payment).
