# Documentation > Guides for writing context, connecting agents and reviewing suggestions, and for running the service. ## Start - [Try the demo](https://getfootnote.vercel.app/docs/next/try-the-demo/): The quick start. Install the demo on your computer with Docker, ask it a question, and connect Claude Code to it. - [Set up your workspace](https://getfootnote.vercel.app/docs/next/set-up-your-workspace/): The six steps from an empty workspace to a first checked answer, and the page for each step. - [Connect an agent](https://getfootnote.vercel.app/docs/next/connect-an-agent/): One prompt for Claude, Cursor or another agent, and what approving does. - [Words](https://getfootnote.vercel.app/docs/next/words/): The glossary of the ten words the screens and these pages use, each in one sentence. ## Ask - [Ask a question](https://getfootnote.vercel.app/docs/next/ask-a-question/): Ask about a number, read how the answer was made, ask again at other dates, and tell the owner what is missing. - [Answer lines](https://getfootnote.vercel.app/docs/next/answer-lines/): The six lines an answer starts with, and what each one asks of you. - [Privacy](https://getfootnote.vercel.app/docs/next/privacy/): What is kept about questions, what is never kept, and who can see a chat. ## Write and review - [Write context](https://getfootnote.vercel.app/docs/next/write-context/): What a context item is, what to put in it, its source and its check date. - [Review a suggestion](https://getfootnote.vercel.app/docs/next/review-a-suggestion/): The quick view, the review, Try it, and publishing, returning or closing. - [Keep context up to date](https://getfootnote.vercel.app/docs/next/keep-context-up-to-date/): The Inbox cards for a context item that is due for a check or was reported, and the ways to answer each. - [When nothing is written yet](https://getfootnote.vercel.app/docs/next/when-nothing-is-written-yet/): The Inbox card a question with no answer raises, and how to write the context, check a draft or close it. - [Decide a conflict](https://getfootnote.vercel.app/docs/next/decide-a-conflict/): Two items that say different things: compare them, then keep one, narrow one or keep both. - [Definitions and synonyms](https://getfootnote.vercel.app/docs/next/definitions-and-synonyms/): Metrics and terms, other names for them, and why some are read-only. - [Publish without review](https://getfootnote.vercel.app/docs/next/publish-without-review/): Let one agent publish low-risk new items in your domain, as your decision, and turn it off. ## Set up - [Domains and owners](https://getfootnote.vercel.app/docs/next/domains-and-owners/): Who publishes what, how to add a domain, the sandbox, and inviting people. - [Integrations](https://getfootnote.vercel.app/docs/next/integrations/): Connect where metrics are defined and where documents live, and what is read. - [See what agents asked](https://getfootnote.vercel.app/docs/next/see-what-agents-asked/): Observability for owners and admins - what agents asked and got, saved questions in Quality, feedback, and alerts. - [Variants: a dimension, not a metric each](https://getfootnote.vercel.app/docs/next/metric-variants/): Why one metric with currency as a dimension works better than a metric for each currency. ## How it works - [How agents use it](https://getfootnote.vercel.app/docs/next/how-agents-use-it/): Published context only, one answer line first, and what happens when nothing is written down. ## Run the service - [Where to run Footnote](https://getfootnote.vercel.app/docs/next/where-to-run/): Docker Compose, a cloud host or container platform, or Vercel for the demo, and what each one asks of you. - [Use your own data](https://getfootnote.vercel.app/docs/next/use-your-own-data/): Run it on one computer with your own semantic layer instead of the demo, and keep a private profile apart. - [Run in production](https://getfootnote.vercel.app/docs/next/run-in-production/): Run the service and web images for real people, behind a TLS proxy, with company sign-in and their keys kept. - [Set up company sign-in](https://getfootnote.vercel.app/docs/next/company-sign-in/): Let people sign in to the web app with your company's OpenID Connect provider, and choose who may join. - [Agent sign-in settings](https://getfootnote.vercel.app/docs/next/agent-sign-in-settings/): The login server agents sign in through, how long a sign-in lasts, and how to make and rotate its keys. - [Choose a model provider](https://getfootnote.vercel.app/docs/next/model-providers/): The ways to reach a model, the models tested so far, and who receives what Ask and the test runs send. - [Back up, restore and upgrade](https://getfootnote.vercel.app/docs/next/back-up-restore-and-upgrade/): What to back up, how to prove a backup restores, how to restore it, and how to upgrade and roll an upgrade back. - [Watch the service](https://getfootnote.vercel.app/docs/next/watch-the-service/): Check the service is healthy, read its logs, its request limits and its scheduled jobs, and serve its metrics. - [Service settings](https://getfootnote.vercel.app/docs/next/configuration/): The settings the service reads from its environment when it starts, with their defaults. - [Administer the service](https://getfootnote.vercel.app/docs/next/administration/): Change settings, read the history log, import items, export an edition and use the footnote command. - [Security](https://getfootnote.vercel.app/docs/next/security/): What is scanned on every change, what leaves the service, and where to report a security problem. - [Run the demo on Vercel and Neon](https://getfootnote.vercel.app/docs/next/vercel/): The web app as static files, the service as one function, and PostgreSQL 18 on Neon. ## Connectors - [Connectors](https://getfootnote.vercel.app/docs/next/connectors/): How the service reads the tools you already use, what each connector brings in, and what a read may change. - [The Cube connector](https://getfootnote.vercel.app/docs/next/connectors/cube/): Reading definitions from Cube model files, in a Git repository or a folder on the server. - [Cube Cloud](https://getfootnote.vercel.app/docs/next/connectors/cube-cloud/): Reading metrics and dimensions from the metadata of a Cube Cloud deployment, through its APIs. - [dbt MetricFlow](https://getfootnote.vercel.app/docs/next/connectors/dbt-metricflow/): Reading metrics and dimensions from the semantic manifest your dbt pipeline writes, wherever it puts the file. - [Static list](https://getfootnote.vercel.app/docs/next/connectors/static-list/): Metrics and dimensions an admin writes in the form as a JSON list, for a trial or a team without a semantic layer. - [Markdown in Git and Google Drive](https://getfootnote.vercel.app/docs/next/connectors/documents/): The two document connectors, which turn new and changed documents in the folders you choose into suggestions for owners. - [Connector security](https://getfootnote.vercel.app/docs/next/connectors/security/): What a connector may reach, how its credentials are kept, and how its output is treated. - [Build a connector](https://getfootnote.vercel.app/docs/next/connectors/authoring/): Add a connector for your tool, by hand or with a coding agent, from the template to a passing kit. ## Reference - [Agent tools](https://getfootnote.vercel.app/docs/next/tools/): The six tools an agent can call, what each takes and gives back, and how to read a reply. - [Connect an agent by hand](https://getfootnote.vercel.app/docs/next/reference/connect-by-hand/): The MCP address, each agent's own steps, access keys for bots, and the limits on what an agent may send. - [HTTP API overview](https://getfootnote.vercel.app/docs/next/reference/http-api/): How to call the service from a script, and where each part of the API is described. ## Optional - [What's new](https://getfootnote.vercel.app/docs/next/changelog/): Changes people notice, newest first. - [Every page in one file](https://getfootnote.vercel.app/docs/next/llms-full.txt): the pages above as Markdown, in order.