# Houston

> Houston is a safe portal to org data for teams already using agents (Codex, Grok, Claude, Cursor). Humans install a skill. Agents use the CLI. Humans never use the CLI. Credentials for Gmail, Drive, Postgres, and ClickHouse stay on the Houston server. The only secret on the device is the Houston login. Agents generate code; Houston runs it deterministically.

Houston is for agents, not humans. A person adds the skill to the agent they already use. The agent installs the CLI from this server, asks that person to log in, and then talks only to Houston. Connector secrets never enter model context or the device.

This file is the curated map. Follow the links. Do not scrape the HTML site for instructions.

## Start

- [Skill](https://ok-houston.com/skill): SKILL.md for Grok, Claude, Codex, and Cursor. The person installs this; the agent does the rest.
- [Markdown home](https://ok-houston.com/index.md): landing page in markdown (headline, lead, get started).
- [Get started](https://ok-houston.com/continue): human signup and sign-in. Then the agent runs `houston login` (browser).
- [CLI installer](https://ok-houston.com/install.sh): POSIX script the agent pipes to sh. Humans do not run the CLI.

## Use

- [Login](https://ok-houston.com/skill): the agent runs `houston login --server https://ok-houston.com`. A browser opens so the person can sign in. Do not ask for a dashboard token.
- [Scripts](https://ok-houston.com/skill): agents use Houston only through Luau (`houston execute`). List connectors, read description and doc, call connector functions.
- [Gmail](https://ok-houston.com/index.md): mail through Houston. Gmail credentials stay server-side.
- [Google Drive](https://ok-houston.com/index.md): files through Houston. Drive credentials stay server-side.
- [Google Calendar](https://ok-houston.com/index.md): events through Houston. Calendar credentials stay server-side.
- [Postgres](https://ok-houston.com/index.md): SQL through Houston with that person's grants. The DSN stays server-side.
- [ClickHouse](https://ok-houston.com/index.md): analytics through Houston. Credentials stay server-side.

## Docs

- [README](https://github.com/aduermael/orb/blob/main/README.md): what Houston is, the demo, and how the stack runs.
- [Philosophy](https://github.com/aduermael/orb/blob/main/PHILOSOPHY.md): product contract. Agents are the users. Minutes to value.

## Optional

- [GitHub repository](https://github.com/aduermael/orb): source.
- [This map](https://ok-houston.com/llms.txt): agent-discovery file you are reading.
- [robots.txt](https://ok-houston.com/robots.txt): origin allows AI crawlers. Cloudflare may still rewrite this at the edge.