# Dozer Docs

> Your AI Equipment Manager. Machine-readable docs for Dozer — 58 pages. Every capability has a human door and an agent door: same gates, same objects, same timeline.

## Introduction

- [What Dozer is](https://trydozer.com/docs): Dozer runs equipment operations: connect machines and cameras, watch live telemetry, and put your site on every screen.
- [Build with AI](https://trydozer.com/docs/start/build-with-ai): One onboarding prompt stands up equipment, mechanics, telemetry, and dashboards for a new site.
- [Connect Your Agent](https://trydozer.com/docs/start/connect-agent): Point a coding agent, a business agent, or any MCP client at Dozer — one server URL, one token, three ways to wire it.

## Get Started

- [Set Up Your Project](https://trydozer.com/docs/get-started/set-up-project): What the setup skill parses and seeds.
- [Upload Your Equipment](https://trydozer.com/docs/get-started/upload-equipment): Create machines one at a time or in bulk, and place them.
- [Connect Devices & Cameras](https://trydozer.com/docs/get-started/simulate-cameras): CANedge, Argos Vision, and simulating a feed before hardware arrives.
- [Create a Dashboard](https://trydozer.com/docs/get-started/create-dashboard): A dashboard is a saved view of live data, not a screenshot.
- [Put It on a Screen](https://trydozer.com/docs/get-started/create-playlist): Playlists rotate dashboards on an unattended display.
- [Operate Day to Day](https://trydozer.com/docs/get-started/screen-played): Tickets, shift reports, and the crew who close them.

## API

- [API Quickstart](https://trydozer.com/docs/api/quickstart): Create a project, set up equipment operations, link a device, and share a TV playlist.
- [Site & Fleet](https://trydozer.com/docs/api/fleet): Machines, crew and the places they work — the four records every other Dozer workflow points at.
- [Devices & Media](https://trydozer.com/docs/api/devices): CANedge loggers, cameras and their media — provisioning, keys, workers, freshness, and the status fields each one owns.
- [Vision AI](https://trydozer.com/docs/api/vision): How a camera frame becomes structured site state — the dozer-video-vision worker skill, its prompt contract, and the ceilings that stop it.
- [Daily Ops](https://trydozer.com/docs/api/ops): Pre-trip checks, shift reports, repair tickets, quick actions and what the agent has learned about your site.
- [Mechanic AI](https://trydozer.com/docs/api/mechanic): Severity triage, mechanic routing, escalation, and the maintenance Dozer suggests before something breaks.
- [TV & Dashboards](https://trydozer.com/docs/api/screens): Boards that put a site's live state on a screen, playlists that rotate them, and the share token that runs an unattended TV.
- [Control Plane](https://trydozer.com/docs/api/control-plane): Projects, run modes, the approval brake, and the spend cap — the operator controls that decide whether a run may start, and the named refusals when one does not.
- [Debugging a Run](https://trydozer.com/docs/api/debugging-a-run): Get a run id, read the status block, tell success from a visible failure, and name the failure class — without guessing from silence.
- [Platform](https://trydozer.com/docs/api/platform): An annotated index of the platform contract every Dozer surface shares — tasks, data, timeline, usage, integrations, skills, and the cross-cutting reference pages.
- [MCP Tools](https://trydozer.com/docs/reference/mcp-tools): Every mcp__dash__* tool available to Dozer, with arguments and a minimal call.

## Skills

- [Skills](https://trydozer.com/docs/skills): The dozer skill catalog.

## Reference

- [API Resources](https://trydozer.com/docs/collections): Every REST resource dozer serves, with its operations.
- [Integrations](https://trydozer.com/docs/integrations): Every provider this product connects to.
- [llms.txt](https://trydozer.com/docs/reference/llms-txt): The machine index of these docs — every page, as plain text, for an agent to read.

## Other pages

Served and linked from the pages above, but not in the sidebar.

- [Agent Onboarding](https://trydozer.com/docs/agent-onboarding): The paste-once bootstrap — everything an arbitrary agent needs to start driving this agent, in one fetch.
- [Artifacts](https://trydozer.com/docs/collections/artifacts): Files and images produced or uploaded by the agent.
- [Custom Actions](https://trydozer.com/docs/collections/custom-actions): Owner-defined quick actions — a label, an emoji and the prompt they launch.
- [Dashboards](https://trydozer.com/docs/collections/dashboards): Boards that put a site's live state on a screen.
- [Devices](https://trydozer.com/docs/collections/devices): CANedge loggers, cameras and other hardware reporting telemetry.
- [Equipment](https://trydozer.com/docs/collections/equipment): Machines on your site — the unit numbers your crew already uses.
- [Integrations](https://trydozer.com/docs/collections/integrations): Provider credentials attached to a project.
- [Learnings](https://trydozer.com/docs/collections/learnings): What the agent learned about your site, kept as create/remove facts.
- [Locations](https://trydozer.com/docs/collections/locations): Sites, pits and zones your machines are assigned to.
- [Mechanics](https://trydozer.com/docs/collections/mechanics): The crew who maintain the machines.
- [Operators](https://trydozer.com/docs/collections/operators): The crew who run the machines.
- [TV Playlists](https://trydozer.com/docs/collections/playlists): Rotations of dashboards for an office TV.
- [Preferences](https://trydozer.com/docs/collections/preferences): Per-project dashboard state (notification read/cleared markers).
- [Repair Tickets](https://trydozer.com/docs/collections/repair-tickets): Work to be done on a machine, from flagged to fixed.
- [Shift Reports](https://trydozer.com/docs/collections/shift-reports): What each shift moved, and what stopped it.
- [Skills](https://trydozer.com/docs/collections/skills): Skills this agent can run, and where their executed bytes come from.
- [Data](https://trydozer.com/docs/core/data): Read and write objects in a project's Data collections with a PAT — data_set, data_get, data_query, data_batch. Every field name is snake_case.
- [Integrations](https://trydozer.com/docs/core/integrations): Provider credentials, the credential-blind call proxy, the capability catalog, and risk classes — discover the contract, never hardcode a provider.
- [Tasks](https://trydozer.com/docs/core/tasks): Create, run, and read tasks — every unit of agent work runs as a task with one status read and one transcript read.
- [Timeline](https://trydozer.com/docs/core/timeline): Append and read human-readable events on any object — events, provenance, and timestamp touches.
- [Usage](https://trydozer.com/docs/core/usage): Read a project's credit spend and the per-run itemized cost — usage_summary and the usage_line_items block on a run's status.
- [Argos](https://trydozer.com/docs/integrations/argos): AI vision insights from any camera you already own.
- [CanEdge](https://trydozer.com/docs/integrations/canedge): Decode CAN-bus telemetry from CANedge loggers.
- [Ring](https://trydozer.com/docs/integrations/ring): Bring Ring cameras into Dozer equipment monitoring.
- [Surge SMS](https://trydozer.com/docs/integrations/surge-sms): Platform-provided SMS delivery for invites and device alerts.
- [Authentication](https://trydozer.com/docs/reference/auth): Per-route authentication modes and required scopes.
- [Conventions](https://trydozer.com/docs/reference/conventions): Cross-cutting API conventions — id prefixes, snake_case fields, epoch-millisecond time, and credit-denominated money.
- [Error Codes](https://trydozer.com/docs/reference/errors): The canonical REST error codes and their default HTTP status.
- [Product operations](https://trydozer.com/docs/reference/operations): The exact operations served by this product and its model tools.
- [Pagination](https://trydozer.com/docs/reference/pagination): List endpoints return a bounded page — pass limit and offset, and read has_more to decide whether to ask for another page.
- [Code Lookup](https://trydozer.com/docs/skills/code-lookup): Diagnose equipment fault codes — SPN/FMI lookup with manual references and repair recommendations.
- [Pre-Trip Inspection](https://trydozer.com/docs/skills/pre-trip): Digital pre-trip checklist with photo capture and automatic fault ticketing.
- [Shift Reports](https://trydozer.com/docs/skills/shift-report): End-of-shift production data capture — loads, tons, hours, downtime tracking.
- [Telemetry Onboarding](https://trydozer.com/docs/skills/telemetry-onboarding): Resolve telemetry hardware, suggest equipment matches, and link confirmed devices through the declared product API.

## Installable skills

Executable operator procedures, published with a content hash. To use one:

1. Fetch `https://trydozer.com/docs/skills/index.json`.
2. For each skill you want, compare its `version` to your cached copy's.
   `version` is the sha256 of `SKILL.md` and equals the hash the platform
   records as that skill's `executed_hash` — identical version, identical
   bytes, no refetch needed.
3. On a change, fetch `skill_url` (the executable `SKILL.md`), or download
   `zip_url` / each `files[].url` for a multi-file skill. Record the new
   `version`.
4. `SKILL.md` is the executable procedure; `references/*` are its contracts
   and `scripts/*` are read-only helpers. Follow the body — it names the
   live doc pages to read rather than restating them.

- [Code Lookup](https://trydozer.com/docs/skills/code-lookup): Diagnose equipment fault codes — SPN/FMI lookup with manual references and repair recommendations. (version `b2e15db89d34…`)
- [Pre-Trip Inspection](https://trydozer.com/docs/skills/pre-trip): Digital pre-trip checklist with photo capture and automatic fault ticketing. (version `4706541999ab…`)
- [Shift Reports](https://trydozer.com/docs/skills/shift-report): End-of-shift production data capture — loads, tons, hours, downtime tracking. (version `37a1f1be8d5c…`)
- [Telemetry Onboarding](https://trydozer.com/docs/skills/telemetry-onboarding): Resolve telemetry hardware, suggest equipment matches, and link confirmed devices through the declared product API. (version `bdbdf36a8721…`)

## Operational notes

- Raw markdown for any page above: `https://trydozer.com/docs/raw/<slug>.md`
- Machine index of every page: `https://trydozer.com/docs/index.json`
- Machine index of every skill: `https://trydozer.com/docs/skills.json` (also at `https://trydozer.com/.well-known/skills/index.json` on the docs host)
- The whole corpus as one document: `https://trydozer.com/docs/llms-full.txt`
- This file: `https://trydozer.com/docs/llms.txt`
- API base: `https://trydozer.com/api/v1`
- Auth: `Authorization: Bearer $DASH_API_KEY` (a `pat_…` workspace token), and name the project with the `Project-ID` header.
- Bootstrap an agent in one paste: Read and follow https://trydozer.com/docs/raw/agent-onboarding.md