# Jig's documentation

Every page, grouped by what you are doing. New to Jig? The first row of the first table is the place to start.

## Start

| Page | What it covers |
|---|---|
| [Your first hour](first-hour.md) | Install to your first approval, the sandbox check and `/lens` |
| [Setup and doctor](setup-and-doctor.md) | `jig setup`, `jig doctor`, the home, packages and updating |
| [Reading paths](reading.md) | The longer order through the concepts, for when you have an afternoon |

## Concepts

| Page | What it covers |
|---|---|
| [Architecture](architecture.md) | The tool manager, the sandbox boundary and where each plugin fits |
| [Permissions](permissions.md) | Environments, rules per tool, and the floor configuration cannot lower |
| [How the agent learns Jig](agent-skills.md) | The ten skills, the tools' one-line snippets, and company overlays |
| [Approvals](approvals.md) | How and where you are asked, inside the waiting call |
| [Secrets](secrets.md) | Where credentials come from, and the stores Jig reads |
| [Compatibility](compatibility.md) | What Jig is tested with, which names are public, what counts as breaking |
| [Decisions](decisions.md) | What was decided, what was rejected, and why |
| [Glossary](glossary.md) | The terms these pages use |

## Guides

| Page | What it covers |
|---|---|
| [Writing a company plugin](company-plugin.md) | The seams, in order, for one company's systems |
| [Browser theme](browser-theme.md) | The graphite and light palettes, tokens and contrast |
| [The launcher](launcher.md) | The optional tmux launcher, its flags and variables |

## Plugin reference

| Page | What it covers |
|---|---|
| [Plugins](plugins.md) | Every tool, its actions and the plugin that owns it, with each README |

## Contributing

| Page | What it covers |
|---|---|
| [Contributing](../CONTRIBUTING.md) | Setup, the checks, where code goes, and running one test file |
| [Writing the docs](writing.md) | The rules these pages follow, and the root README's order |
| [Integration tests](integration-tests.md) | The suites that talk to a real service, and how to run them |
| [Releases](releases.md) | What a version means, and how one is cut |
| [Front-end contracts](contracts.md) | The versioned files jig-herdr reads |
| [Relay protocol](relay-protocol.md) | Version 1 of the relay's messages and fixtures |
| [Reuse](reuse.md) | Existing packages before our own |

Back to [the README](../README.md).
