---
title: "Concepts"
description: "The ideas Commentware is made of, and the choices in it that a reader would otherwise take for bugs."
---

> Documentation Index
> Fetch the complete documentation index at: https://commentware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Concepts

These pages say what Commentware is made of and why it behaves as it does.
Nothing on them is a step to follow; each one ends with the page that puts it
to use.

- **[Threads and pins](/docs/concepts/threads-and-pins/)** — what a comment is
  attached to, and how its pin finds that element again after the page changes.
- **[Projects, sites and pages](/docs/concepts/projects-and-sites/)** — the three
  levels a comment is filed under, and the one you name yourself.
- **[Shared, not live](/docs/concepts/shared-not-live/)** — what you see of
  other people's comments, and when.
- **[Links to a comment](/docs/concepts/comment-links/)** — what a permalink
  carries, and which site serves it.
- **[A server only your machine can reach](/docs/concepts/local-servers/)** —
  why a server on `127.0.0.1` works, and what changes when somebody else needs
  it.
- **[How a command finds its server](/docs/concepts/config-file/)** — the file
  that says which server a directory means, and what stays out of it.
- **[How the extension and a server agree](/docs/concepts/versions/)** — how two
  pieces that ship separately find out what the other one speaks.
- **[Notifications](/docs/concepts/notifications/)** — what gets
  you told, how often, and the list that catches what your system dropped.
- **[Dialogs that block the page](/docs/concepts/dialogs/)** — why comments
  sometimes cannot be clicked, and the two modes that decide who can.
- **[Where dictation runs](/docs/concepts/dictation/)** — whose microphone it is,
  who recognizes your voice, and when the microphone is open.
- **[What the server deletes on its own](/docs/concepts/retention/)** — the
  backup a migration writes first, and the purge of old resolved threads.
- **[What an agent can do](/docs/concepts/agents/)** — an agent as a user, the
  endpoint it reaches, and what it deliberately cannot do.
- **[How the install works](/docs/concepts/install/)** — what the installer
  checks, and why the steps ask for what they do.