# Cassis documentation

> Cassis does context maintenance for analytics agents. It keeps the context they read
> current, tested, and approved as schemas and definitions change. The approved ontology
> generates and runs the SQL behind every answer; questions, clarifications, evals, and
> source changes surface gaps and drift for the data team to review.

Start here if you are an agent: [For agents](https://docs.getcassis.com/for-agents/) is the operating
contract, covering which surface to use, how to authenticate, what to read first, and
where a human must take over. Every link below is raw Markdown of the rendered page.

## Guides

### Introduction

- [Documentation home](https://docs.getcassis.com/raw/index.md): Try Cassis on sample data, ask from an MCP client, request access for your warehouse, or browse guides by job.
- [What Cassis is](https://docs.getcassis.com/raw/start/overview.md): Where Cassis fits in your stack and how a business question becomes an answer.
- [Explore a real ontology](https://docs.getcassis.com/raw/start/ontology.md): See one complete project, its four object types, and how agents traverse the same context in the app and a repository.
- [Try the guided demo](https://docs.getcassis.com/raw/start/try.md): See a context gap become governed knowledge in the built-in Stallora tour.

### Get started

- [Get started overview](https://docs.getcassis.com/raw/build.md): Choose how to manage the ontology, connect data, and start modeling.
- [Choose how your ontology is managed](https://docs.getcassis.com/raw/start/choose.md): Use git by default, or the web app when ontology owners do not work in git.
- [Connect a warehouse or upload DDL](https://docs.getcassis.com/raw/setup/warehouse.md): A live connection, or a schema file when there is none. What each changes about answers.
- [Install and configure the CLI](https://docs.getcassis.com/raw/build/cli.md): Install and authenticate the CLI used by git-managed workflows.
- [Set up a git-managed project](https://docs.getcassis.com/raw/build/git-workflow.md): Add the ontology files, connect the repository, and protect changes with CI.
  - [Add the ontology files](https://docs.getcassis.com/raw/build/bootstrap.md): Pull the current ontology into the repository, or start from the minimal example.
  - [Connect a git repository](https://docs.getcassis.com/raw/build/git-connect.md): Use the GitHub App, or publish from CI on any other provider.
  - [Set up CI](https://docs.getcassis.com/raw/build/ci.md): What runs on a pull request and on the default branch, with copy-paste jobs.
  - [Troubleshoot git and publishing](https://docs.getcassis.com/raw/build/troubleshooting.md): Fix a failed check, a missing check, or a merge that did not publish.

### Ask your data

- [Ask your data overview](https://docs.getcassis.com/raw/ask.md): Get answers in the web app, from your editor over MCP, or in Slack.
- [Ask in the web app](https://docs.getcassis.com/raw/ask/web-app.md): Chat, plans you confirm, the SQL, and the feedback that feeds the ontology.
- [Connect and ask from an MCP client](https://docs.getcassis.com/raw/ask/mcp.md): Connect any MCP-compatible client. Claude Code, Claude Desktop, and Cursor are examples.
- [Ask in Slack](https://docs.getcassis.com/raw/ask/slack.md): Mention the bot in a channel and keep the thread as the conversation.
- [Understand plans, answers, and provenance](https://docs.getcassis.com/raw/ask/answers.md): How to read a plan, the SQL, the objects used, and what to do when the answer is wrong.

### Curate and govern your context

- [Curate and govern your context overview](https://docs.getcassis.com/raw/curate.md): Keep the ontology right through reviewed app-managed or git-managed changes.
- [How the curation loop works](https://docs.getcassis.com/raw/curate/loop.md): Follow a gap from detection through evidence, review, testing, and publication.
- [Curate a git-managed project](https://docs.getcassis.com/raw/curate/agent.md): Take an issue through a tested pull request, with a person or an agent doing the implementation.
  - Detect and diagnose
    - [Review detected issues](https://docs.getcassis.com/raw/curate/issues.md): Prioritize context gaps, read the evidence, and choose the right response.
    - [Run the consistency audit](https://docs.getcassis.com/raw/curate/consistency.md): Find missing or ambiguous context before it causes bad answers.
    - [Review data-source changes](https://docs.getcassis.com/raw/curate/data-source-changes.md): See what changed in the schema and which ontology objects need attention.
  - Control changes
    - [Work on branches](https://docs.getcassis.com/raw/curate/branches.md): Build a bigger change in parallel without touching what is live.
    - [Build and run evals](https://docs.getcassis.com/raw/curate/evals.md): Protect approved answers with reviewed question-and-SQL cases.
    - [Publish and restore versions](https://docs.getcassis.com/raw/curate/versions.md): What makes a change live, what a version records, and how to go back.
- [Curate an app-managed project](https://docs.getcassis.com/raw/curate/web-app.md): Watch one issue become a published fix on screen, and edit app-managed projects.

### Admin

- [Admin overview](https://docs.getcassis.com/raw/setup.md): Projects, people and permissions, keys, and integrations.
- [Projects](https://docs.getcassis.com/raw/setup/projects.md): What a project binds together, who can create one, and what is organization-wide.
- [Members and roles](https://docs.getcassis.com/raw/setup/members.md): Invite people, assign a role, and suspend or reactivate access.
- [Domain permissions](https://docs.getcassis.com/raw/setup/permissions.md): Restrict who edits which part of the ontology, through groups and domain grants.
- [API keys](https://docs.getcassis.com/raw/setup/api-keys.md): For the CLI, CI, and non-interactive agents. Interactive clients use OAuth.
- [Install Slack](https://docs.getcassis.com/raw/setup/slack.md): One install per organization, then map each channel to a project.

## Reference

- [Reference overview](https://docs.getcassis.com/raw/reference.md): The capability matrix, the CLI, the MCP tools, the ontology schema, and limits.
- [Capability matrix](https://docs.getcassis.com/raw/reference/capabilities.md): Compare what the web app, MCP, CLI, and repository can do.
- [CLI](https://docs.getcassis.com/raw/reference/cli.md): Commands, options, output, and exit codes.
  - [Ontology commands](https://docs.getcassis.com/raw/reference/cli/ontology.md)
  - [Schema commands](https://docs.getcassis.com/raw/reference/cli/schema.md)
  - [Eval commands](https://docs.getcassis.com/raw/reference/cli/eval.md)
  - [Issues commands](https://docs.getcassis.com/raw/reference/cli/issues.md)
  - [Source-change commands](https://docs.getcassis.com/raw/reference/cli/source-changes.md)
  - [Projects and status](https://docs.getcassis.com/raw/reference/cli/projects.md)
- [MCP](https://docs.getcassis.com/raw/reference/mcp.md): Endpoint, authentication, tool parameters, and response fields.
  - [Endpoint and authentication](https://docs.getcassis.com/raw/reference/mcp/endpoint.md)
  - [ask_question](https://docs.getcassis.com/raw/reference/mcp/ask-question.md)
  - [Projects and status](https://docs.getcassis.com/raw/reference/mcp/projects.md)
  - [Source schema](https://docs.getcassis.com/raw/reference/mcp/source-schema.md)
  - [Source changes](https://docs.getcassis.com/raw/reference/mcp/source-changes.md)
  - [Issues](https://docs.getcassis.com/raw/reference/mcp/issues.md)
  - [Evals](https://docs.getcassis.com/raw/reference/mcp/evals.md)
- [Ontology schema](https://docs.getcassis.com/raw/reference/schema.md): File layout and fields for domains, tables, joins, and metrics.
  - [Layout](https://docs.getcassis.com/raw/reference/schema/layout.md)
  - [Domains](https://docs.getcassis.com/raw/reference/schema/domains.md)
  - [Tables and joins](https://docs.getcassis.com/raw/reference/schema/tables.md)
  - [Metrics](https://docs.getcassis.com/raw/reference/schema/metrics.md)
- [Limits and errors](https://docs.getcassis.com/raw/reference/limits.md): Timeouts, payload caps, exit codes, and what each failure means.

## Changelog

- [Changelog overview](https://docs.getcassis.com/changelog/): What shipped, by release, filterable by app, CLI, and MCP.

## Utility

- [For agents](https://docs.getcassis.com/raw/for-agents.md): which surface to use, how to authenticate, what to read, where to stop.