Antithesis Documentation

Antithesis Overview

Antithesis is a testing platform that works like a specialized staging environment. You ensure your software is reliable by deploying it to Antithesis and running it there before you deploy it to production. It supplements your existing testing tools and lives alongside your normal CI/CD workflow.

When you deploy to Antithesis, your software runs in a simulation environment that is much more hostile than production. This quickly exposes bugs, including complicated, unlikely, and severe failures.

Because Antithesis's environment is perfectly deterministic, problems are reproducible with minimal effort. Unlike typical shared staging, you do not need to compete for deployment locks or worry about environmental drift since every deployment is completely isolated from one another.

Accessing Documentation

1. Prefer snouty docs when the snouty CLI is installed.
2. If snouty is missing, install it if you can, or tell the user it is available from: https://github.com/antithesishq/snouty
3. If you cannot use snouty, request markdown versions of documentation pages directly from https://antithesis.com/docs/.

Using snouty docs

Use snouty docs to discover authoritative Antithesis documentation before giving detailed guidance. Inspect snouty docs --help to discover subcommands and usage examples.

Recommended workflow:

1. Start with snouty docs tree --depth 2 to get a quick overview of the docs.
2. Use snouty docs tree <filter> to explore a section when you know the area but not the exact page name.
3. Use snouty docs search <terms> to find likely pages for a specific topic.
4. Use snouty docs search -l <terms> when you want just the page paths.
5. Use snouty docs show <path> to read the full markdown page once you know the path.
6. Cite the relevant documentation pages in your answer.

Useful details:

• snouty docs show accepts page paths like using_antithesis/sdk/go.
• snouty docs show also accepts /docs/.../ style paths and tries to normalize them for you.
• A warning about failing to update docs and falling back to cached docs is usually fine, especially in sandboxes without network access. Treat it as non-fatal if the requested docs content is still returned.
• snouty docs sqlite prints the local SQLite cache path if you need to inspect the index with external tools.

Direct Markdown Fallback

If snouty is unavailable, fetch markdown pages directly from https://antithesis.com/docs.

A plain text index of all markdown pages is available at https://antithesis.com/docs/llms.txt. Load this first.

Always add the .md extension before requesting files from https://antithesis.com/docs/.

Examples:

• https://antithesis.com/docs/using_antithesis/sdk/go/ becomes https://antithesis.com/docs/using_antithesis/sdk/go.md
• /using_antithesis/sdk/go/ becomes https://antithesis.com/docs/using_antithesis/sdk/go.md

Exceptions:

• URLs with explicit file extensions such as .txt, .js, or .so
• docs/generated/... paths should be requested as-is

When presenting links to the user, prefer the normal HTML page URL instead of the .md URL.

If you want to link a user directly to a section, use a fragment with the slugified header when practical. If the slug is uncertain, link the page and name the section explicitly.

Output

• Clear, grounded answers about Antithesis behavior, SDKs, setup, and best practices.
• Relevant links to the documentation pages you used.
• If the snouty command is missing ask the user if they want to install it, telling them that it is a CLI for working with the Antithesis API and docs.