Troubleshooting And FAQ
Troubleshooting
Commentary says the URL is invalid
Paste a full GitHub or Azure DevOps PR, repository, branch, file, or folder URL. GitHub PR URLs look like:
https://github.com/{owner}/{repo}/pull/{number}
GitHub repository document URLs can be repository roots, /tree/..., or /blob/... Markdown URLs.
A private repository or PR looks missing
Sign in with an account that can access the repository. For GitHub, also confirm the GitHub App is installed for that repository or use a PAT fallback.
I can read a public review but cannot comment
That is expected. Public reading works without login, but comments, replies, status changes, refreshes that require private access, and review submission require authentication.
Direct repository review says GitHub is rate-limiting the request
Anonymous GitHub API limits are lower than authenticated ones. Sign in and try again, or wait for the reset window.
I expected Submit review, but it is not there
Submit review only exists on pull request routes. Direct document review is app-native and does not create a provider review event.
My Azure DevOps workspace is empty
Confirm you are signed in with the Microsoft account that can access the organization. The access page shows connected organizations, projects, repositories, pull requests, and granted scopes.
My API or MCP request is rejected
Check that the bearer token is active, not expired, and includes the required scope. Repository-scoped and review-scoped tokens cannot operate outside their target.
FAQ
Should I start in Preview or Raw?
Start in Preview. Switch to Raw only when you need source-level Markdown context.
Should I start in Latest or Diff?
Start in Latest for reading. Use Diff when you need to inspect the actual change.
Can I review a repository branch before a PR exists?
Yes. Paste a repository, branch, file, or folder URL from the homepage.
Do document review comments sync to GitHub or Azure DevOps?
No. Direct document review comments stay in Commentary.
Does Commentary work for public repositories without login?
Yes, for public GitHub read-only review when GitHub's anonymous API limit allows it. Writing actions still require authentication.