# pseudobash

> A bash-fluent retrieval surface that lets AI answer engines query a website
> the way an agent would query a filesystem — POST `/shell`, GET `/shell.md`.
> Plain-text in, plain-text out, with citation headers on every response.

This `llms.txt` follows the proposal at https://llmstxt.org/. The full
machine-friendly contract lives at `/shell.md`. A concatenated long-form
version of all citeable pages is available at `/llms-full.txt`.

## Core

- [Retrieval contract (shell.md)](/shell.md): the wire format, headers, supported commands, and crawler allowlist.
- [Homepage](/): product overview and the "be the source ChatGPT cites" pitch.
- [Audit your site](/audit): free scan of how four AI crawlers see your homepage; shareable at `/audit/<host>`.

## Surfaces

- [POST /shell](/shell.md#wire-format): plain-text command in, plain-text terminal output out. Citation block in `X-Pseudobash-Cite`.
- [GET /shell.md](/shell.md): self-describing contract; safe for any crawler.
- [GET /audit/{host}](/audit): live, cached audit of any domain.

## Operational

- [Health](/health): plain-text liveness probe.
- [Sitemap](/sitemap.xml): canonical URL list.
- [AI training opt-in (ai.txt)](/ai.txt): we welcome model training on this content.
- [Security policy](/.well-known/security.txt): coordinated disclosure contact.

## Writing

- [Blog index](/blog): notes on Answer Engine Optimization (AEO).
- [How to show up in ChatGPT results (2026 guide)](/blog/show-up-in-chatgpt-results): pillar guide — crawlers, citation surfaces, verification.
- [How to get traffic from AI agents](/blog/traffic-from-ai-agents): per-agent crawler, referer, and utm reference table for ChatGPT, Perplexity, Claude, Gemini, Copilot.
- [AEO vs SEO: what Answer Engine Optimization actually changes](/blog/aeo-vs-seo): definitions, the passage-level mindset, 5 AEO checks SEO tools miss.
- [llms.txt and ai.txt: a copy-pasteable guide](/blog/llms-txt-and-ai-txt-guide): minimal templates and a robots.txt allowlist for the AI bots that matter today.
- [Why your Google referrals are dropping](/blog/google-referrals-dropping-ai-overviews): diagnosing AI Overview cannibalization (Pew, 2025) and two recovery paths.

## Optional

- [Demo site catalog](/demo/sites): JSON list of benchmark sites available through `/shell`.
- [Embeddable widget](/public/widget.js): drop-in script for site owners.