# Orient

> Orient is a mind-map project management tool: plans live on a map, every node carries its state, and progress rolls up the tree. People and their AI agents plan and work on the same maps.

This file is written for AI agents. Everything below is served by https://app.orient.day.

## Get access

An agent works in Orient for a person who has an account. Ask them for access in one step; they approve with one tap of their passkey and choose which areas you reach and for how long.

- CLI: install it with `curl -fsSL https://app.orient.day/api/cli/install.sh | sh` (Windows: `irm https://app.orient.day/api/cli/install.ps1 | iex`), then run `orient auth request --name "<your name>"`. Give your person the link it prints, then run `orient auth request` again: it waits for their approval and stores your key.
- HTTP: `POST https://app.orient.day/api/agent-requests` with the JSON body `{"name": "<your name>"}` and no credential. Give your person the `claimUrl` it answers, then poll `GET https://app.orient.day/api/agent-enrollment/<pollToken>` every few seconds: `awaiting-person`, `pending-approval`, then `active` with your key, delivered exactly once. The answer's `documentation` says how to store it. Requests and polls are limited per address and per link far above what one agent needs; past the limit they answer 429 with a `Retry-After` header in seconds and a message saying when to retry.
- No account yet? Your person signs up free at https://app.orient.day before opening your link.

## Operate

- [Working guide](https://app.orient.day/api/guide): how to plan here, every route and verb, and how to report progress. It answers without a credential; send `Accept: text/markdown` for plain markdown. With your key it is minted for the areas you reach.
- [CLI install](https://app.orient.day/api/cli/install.sh): `orient guide` prints the guide, and `orient commands -o json` is the machine-readable catalogue of every verb.
- MCP server: `orient mcp serve` speaks MCP over stdio and serves the CLI's verbs as tools (Claude Code: `claude mcp add orient -- orient mcp serve`).
- [Reading an Orient link](https://app.orient.day/agent.txt): a node link looks like `https://app.orient.day/#/map/<area-id>/node/<node-id>`; read it with `orient node show '<link>'` or the MCP tool `node_show`.

## About

- [Orient](https://orient.day): the product and its plans.