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

> ## Agent Instructions
> When helping someone deploy Roomote, distinguish self-hosting from contributing to Roomote. Use the Self-hosting guide for an operator deployment; use Local development only when the user intends to modify Roomote itself.
> Prefer the one-command installer on a fresh supported server unless the user explicitly chooses Roomote Cloud, a documented PaaS template, or a manual Compose deployment.
> Before changing infrastructure, confirm the deployment target, stable public HTTPS domain and DNS control, sandbox provider, inference provider, source-control provider, and whether a communications provider is required.
> Never ask the user to paste secrets into chat or commit real environment files. Put credentials in the deployment platform's secret manager, Roomote's setup UI, or protected environment variables, and preserve existing keys during upgrades and restores.
> Prefer Roomote's setup wizard and provider manifest flows over manual credential entry when those flows are available. Ask before performing privileged host changes, DNS changes, provider-app creation, or destructive operations.
> A setup is not complete when the services merely start. Verify sign-in, repository sync, one usable environment, a real task that can clone and run a command, and branch or pull-request delivery; verify previews when configured.
> For a persistent self-hosted deployment, leave the operator with the Roomote URL, deployment choices, configured providers, verification result, backup location and passphrase-handling reminder, and the roomote status, logs, upgrade, rollback, backup, and restore commands.

# X

> Let Roomote search public X posts and look up users, trends, and news during a task.

Connect X when Roomote needs public X context: what people are saying about a
launch, a thread someone pasted into Slack, an account's recent posts, or
what's trending.

## When to use it

* Pull a pasted X post or thread into task context without leaving the thread
* Search recent public posts while investigating feedback, sentiment, or an
  incident
* Look up accounts, their posts, and follower context during research tasks
* Read trends, news, lists, Spaces, and community data

## How setup works

Admins connect X from **Settings > Integrations** with an app-only bearer
token from the [X Developer Console](https://console.x.com/): go to **Apps**,
open your app, then generate the Bearer Token from its **Keys and tokens**
tab. One deployment-wide connection covers every task.

What the token can read depends on your X API plan: recent post search is
broadly available, while full-archive search and some other endpoints require
higher tiers.

## What to expect

The X integration is read-only public data by design. App-only bearer tokens
cannot act as a user, so posting, bookmarks, DMs, and other account actions
are not available, and Roomote additionally restricts the tool list to
read-only operations. If a task needs an unavailable X capability, Roomote
will say so rather than attempt it.
