# Make your infrastructure legible.

Draw the systems you work with. Connect them to health checks. Keep the context
you need to investigate a problem and choose what to do next.

Reticle starts with a map you author, saved as one YAML file. You choose the
nodes, relationships, and boundaries; configured checks add current observations.
You can use the diagram without configuring any checks or commands.

## Start with one useful map

[Create your first diagram](getting-started.md): open a sample or a new workspace,
draw a service and its dependencies, and add your first HTTP check.

- [Install Desktop](installation.md) — choose a package and prepare the tools your checks need.
- [Understand Desktop and Team](capabilities-and-limitations.md) — choose where your map and checks run.
- [Find a fix](troubleshooting.md) — start with the symptom you see.

## Draw and organize

- [Workspaces and files](workspaces.md) — autosave, YAML, samples, and backups.
- [Draw your map](diagramming.md) — nodes, connections, notes, and embedded pages.
- [Groups and Tree view](hierarchy.md) — containment, reparenting, and group health.
- [Export and share](exporting.md) — PDF, portable YAML, and shared browser access.
- [Keyboard shortcuts](shortcuts.md) — navigate and edit efficiently.

## Connect to live systems

- [Checks and named actions](checks-and-actions.md) — collect evidence and run a reviewed response.
- [Desktop terminals](terminals.md) — SSH and Kubernetes sessions on macOS and Linux.
- [JSON API and MCP](operational-graph.md) — read topology and observations from other tools.
- [Optional chat](chat.md) — ask questions about the graph with OpenAI or local Ollama.

## Share with your team

- [Team Daemon](daemon.md) — one always-on topology, browser access, and viewer/editor roles.
- [Production deployment](production-deployment.md) — install, configure, upgrade, and operate a Linux service.
- [Daemon architecture](daemon-architecture.md) — collection, revisions, and the WebSocket protocol.

## Look something up

- [Topology YAML reference](topology-reference.md)
- [Supported platforms](supported-platforms.md)
- [v1.3.0 release notes](release-notes-v1.3.md), [licensing](licensing.md), and [v1.2 migration guide](migration-v1.2.md)

Reticle complements your monitoring tools. It does not discover infrastructure,
retain metrics or logs, or remediate failures automatically. See
[capabilities and limitations](capabilities-and-limitations.md) for the current boundaries.
