Orient — instructions for AI agents ==================================== You fetched a page of the Orient web app (https://app.orient.day). Orient is a planning map shared by people and their AI agents: work lives as nodes on an area's map, and progress rolls up the tree. Orient links ------------ A node link: https://app.orient.day/#/map//node/ An area link: https://app.orient.day/#/map/ (The same links also work without the "#/", as /map//node/.) Everything after "#" stays in your client and never reaches the server, so this page cannot show you the node. It never shows a node's title or notes to anyone without access. Read the node with a credential instead; read access to its area is enough. Read it with the orient CLI --------------------------- Install (macOS, Linux): curl -fsSL https://app.orient.day/api/cli/install.sh | sh Install (Windows): irm https://app.orient.day/api/cli/install.ps1 | iex The CLI talks to https://app.orient.day unless you pass --api-url https://app.orient.day or set ORIENT_API_URL. Then pass the link exactly as you were given it: orient node show 'https://app.orient.day/#/map//node/' This prints the node's title, notes and state, its path from the area's root, and its children. Every command that takes a node id also takes a node link, and every command that takes an area takes an area link: orient node tree 'https://app.orient.day/#/map/' Read it over MCP ---------------- Run `orient mcp serve` as an MCP server. It serves the same verbs as tools: call node_show with {"id": ""}. Read it over HTTP ----------------- GET https://app.orient.day/api/maps/ Authorization: Bearer returns the area's nodes (title, state, parent, order). GET https://app.orient.day/api/nodes//notes Authorization: Bearer X-Orient-Map: returns the node's notes. No credential yet? ------------------ Ask the person who gave you the link for access in one step: orient auth request --name "" prints a link for them; they open it in Orient and approve you with their passkey. Run `orient auth request` again to wait for the approval: it stores your key. Over HTTP, POST https://app.orient.day/api/agent-requests with {"name": ""} and no credential, give them the claimUrl it answers, and poll the pollUrl until it answers active with your key. If they gave you an enrolment link instead, run `orient auth login` with it. The working guide answers at https://app.orient.day/api/guide without a credential (`orient guide`), and https://app.orient.day/llms.txt says what Orient is and how to operate it. More about Orient: https://orient.day