Getting Started
Use Commentary when you want to review Markdown as a readable document instead of parsing changed lines.
Fastest First Run
- Open /.
- Paste a GitHub or Azure DevOps URL.
- Click
Open review. - Start in
PreviewandLatest. - Sign in only when you need to comment, reply, refresh private content, or submit a review.
Commentary accepts pull request, repository, branch, file, and folder URLs. It resolves the URL to the matching review surface.
What Works Before You Sign In
- Public GitHub pull requests can open read-only.
- You can read rendered Markdown, inspect raw Markdown, and move through files when the public data is available.
- Commentary keeps the document centered so prose reads like a spec, ADR, README, or rollout plan.
When You Need An Account
Sign in when you want to:
- add a new thread
- reply to a thread
- resolve or reopen a thread
- submit a pull request review
- open private repositories
- use the GitHub or Azure DevOps workspace
- create API tokens or connect an MCP client
GitHub App is the default GitHub path. Azure DevOps uses Microsoft Entra by default. PAT options remain available for restricted environments.
Two Good Ways To Explore
- Want a safe sandbox: open /demo and follow Demo walkthrough.
- Want to review docs before a PR exists: paste a repository, branch, file, or folder URL and read Review repository branches.
For team queue work, open the Workspace after signing in.