Troubleshooting
Fix common SpecsGraph problems with sign-in, Git connections, publishing, reviews, agents and notifications, and find out where to ask for help.
Find the symptom in the tables below. Each row names the likely cause and what to do. If nothing here fits, get help.
Sign-in and invitations
Git connections
Publishing
Tasks and publishing explains every publication state, and Branches and pull requests how a task reaches your repository.
Reviews and tasks
Work items and build status
Proposals, plans and review covers accepting staged changes, and Workstreams when a workstream completes.
Agents and MCP
Other MCP clients has the full table for connection problems, including timeouts and missing tools.
Notifications
Notifications and waiting on me lists every kind and how each reaches you.
Get help
- Community. Ask on Discord (opens in a new tab).
- Bugs. Report them on Discord (opens in a new tab) or email us at the contact address.
- Security issues. Report them privately, as described in Report a vulnerability, not in a public channel.
Include what you expected, what happened and the steps that lead there, with any tokens or other secrets removed.
Next steps
- Frequently asked questions: short answers about the product, agents, Git, hosting and pricing.
- How the spec workflow works: how a change moves from staged to published.