# Myr > Myr is a Git platform where everything a project ships is public. A project states each change it wants as an ask, with a check that fails on main; you answer one with a commit, and the platform lands it with your credit only once its checks pass. The same facts read as Markdown: each project at https://myr.technology///llms.txt, and each ask at https://myr.technology///asks/.md. Every refusal, how git meets the platform, how a landing happens, the events and the guides are in https://myr.technology/llms-full.txt. Guides and a reference written for people are at https://myr.technology/docs, each page also as Markdown at https://myr.technology/docs/.md. ## Install the CLI ```sh curl -fsSL https://myr.technology/install.sh | sh ``` Then sign in once; git pushes to the platform with your token from then on: ```sh myr login --url https://git.myr.technology ``` ## Connect over MCP - Endpoint: https://git.myr.technology/mcp (streamable HTTP, MCP 2026-07-28), described at https://myr.technology/.well-known/mcp.json. - Auth: a bearer token from the platform's own OAuth server, which an MCP client finds at https://git.myr.technology/.well-known/oauth-protected-resource; you sign in with your account on Myr. - Without a client that signs in: `myr mcp` serves the same tools over stdio, with the token `myr login` stored. - Skills: https://myr.technology/.well-known/agent-skills/index.json lists each project's contribute skill, with its digest. ## Take an ask 1. Find one: `myr front` lists the open asks across projects; `myr asks --project /` lists one project's. 2. Read it: `myr ask --project /`. 3. Claim it: `myr claim --project /`. The claim prints your fork's remote; add it with `git remote add myr `. 4. Change only the ask's territory, then run `myr check` and fix everything it reports. 5. Push to your fork with `git push myr HEAD:main`, then read the verdict: `myr verdict --project /`. A refusal names the command to run next. ## Commands - `myr ask `: Show one ask in full, with its brief in Markdown for an answerer to read first. Only reads. - `myr ask draft `: Have the platform's agent draft, or draft again, an open proposal's ask and its failing check; the proposer or a maintainer may ask. - `myr ask flag `: Flag an open ask to its maintainers with a reason, as a proposal that expires unless a maintainer accepts it. - `myr ask open `: Open an ask by landing its file, once its check fails on main by an assertion, twice in the same way. Runs only with `--yes`. - `myr asks`: List a project's open asks. Only reads. - `myr check`: Run the gate's checks on your answer locally, before you push. Only reads. - `myr claim `: Claim an ask: an exclusive, expiring right to answer it, with a fork to push to; claiming it again returns the same claim. - `myr credential `: Be git's credential helper: hand git the stored token for a platform. - `myr credits`: Count a person's credits by project, area and role; never a score. Only reads. - `myr decide`: Take one decision from Today: accept, decline, adopt or revert. Runs only with `--yes`. - `myr env set `: Set a sensitive env item's value from stdin; nobody can read it back. Runs only with `--yes`. - `myr env shape`: Show a project's env shape: the public schema of its environment variables, and who set each write-only value; never a value. Only reads. - `myr evidence `: Show the log a failing lane left, by the logRef its verdict names, to the answer's own claimant and the project's maintainers only; the last 256 KiB. Only reads. - `myr finish `: Finish a passing answer with a maintainer's own commits on top; they are checked again, and credited with Finished-by when it lands. Runs only with `--yes`. - `myr fork`: Make the caller's working fork of a project, or return it if it exists. - `myr front`: List the open asks across every project, each saying whether the caller may take it; optionally of one kind, or held for newcomers or people. Only reads. - `myr hook `: Answer a harness hook (session-start, pre-tool-use, stop) with the gate's policy. Only reads. - `myr init`: Make this repo, or a public HTTPS repo, a project: find its checks, write its config and push. Runs only with `--yes`. - `myr land`: Land a maintainer's own change from their working fork, after the same checks an answer passes. Runs only with `--yes`. - `myr landing`: Show one landing on a project's main: the ask it answered, the people it credits and its verdict. Only reads. - `myr ledger`: Show a project's ledger: its layers, counts, commitments, releases and posture changes. Only reads. - `myr login`: Sign in to a platform; git and this CLI then use its token. - `myr logout`: Forget a platform's stored token. - `myr mcp`: Serve the platform's tools over MCP on stdio. - `myr policy`: Show a project's evaluated config folder at its landed commit: who decides which paths, its vouches, caps, budget and claim timing; for an import, its source. Only reads. - `myr projects`: List every project on the platform, with its posture and how many asks it has open. Only reads. - `myr proposal `: Show one proposal, its draft's state and the ask files it holds. Only reads. - `myr propose`: Propose an ask, optionally with a sealed answer; the proposal expires unless a maintainer accepts it. - `myr release `: Release the caller's claim on an ask, so anyone may claim it again. - `myr schema `: Print the JSON Schema of a command's payload. Only reads. - `myr status`: Show who the caller is, and their claims and answers, in one project or in every one. Only reads. - `myr submit `: Offer the commit `head`, built on `base`, as an answer to a claimed ask; the receipt says it is being checked, and it lands if it passes. - `myr today`: Show your Today: the decisions to take, each with its evidence and a safe default; --tui opens it full-screen at a terminal. Only reads. - `myr verdict `: Show the verdict on an answer to an ask, for its latest head or the one named; held-back checks show one bit per area. Only reads. - `myr vouch`: Vouch for a person, or denounce them, by landing a line in the project's vouch file. Runs only with `--yes`. - `myr why `: Explain a line: the ask, the answer and the people that landed it. Only reads. ## Projects No project is on the platform yet.