# Locality

> Locality mounts apps such as Notion and Google Docs as local Markdown files so humans, editors, and agents can read, edit, review, and sync work safely.

## Read first

- [Overview](overview.mdx): Product model, core surfaces, and safety model.
- [Install Locality](install.mdx): OS-specific install paths, GitHub release assets, verification, and updates.
- [Quickstart](quickstart.mdx): Install, connect, mount, edit, diff, and push.
- [Filesystem model](filesystem-model.mdx): How pages, databases, documents, stubs, media, and frontmatter map to files.

## Human workflows

- [Desktop app](desktop.mdx): Onboarding, mounts, files, pending changes, and Live Mode.
- [Best practices](best-practices.mdx): Recommendations for reliable human and agent workflows.
- [Use cases](use-cases.mdx): Engineering wiki updates, meeting notes, content operations, database workflows, OKF export, and safe agent handoff.
- [Sync safety](sync-safety.mdx): Pending changes, remote drift, conflicts, restore, and diagnostics.

## Agent workflows

- [Use with agents](agents.mdx): Agent contract, prompts, Live Mode behavior, and MCP fallback.

Agent rule summary:

- edit mounted Markdown directly;
- preserve Locality frontmatter, block identity directives, `_schema.yaml`, `AGENTS.md`, and `CLAUDE.md`;
- use `loc status` and `loc diff` for inspection;
- do not push unless the user explicitly asks or Live Mode has a safe path;
- prefer scoped paths over broad workspace commands.

## Reference

- [CLI reference](cli-reference.mdx): Essential `loc` command surface.
- [Notion connector](connectors/notion.mdx): Notion projection, databases, supported writes, and common errors.
- [Google Docs connector](connectors/google-docs.mdx): Google Docs projection, supported content, and limits.
- [OKF export](okf-export.mdx): Export mounted content as portable Open Knowledge Format bundles.

## Operations

- [Troubleshooting](troubleshooting.mdx): Provider drift, stale paths, connector errors, conflicts, Live Mode pauses, and build mismatches.
- [Development](development.mdx): Repo setup, desktop dev, checks, daemon, File Provider, publish commands, and docs preview.