For agents
Paste your error, get the known fix, and let your agent do the pasting. Everything on this site is also plain files: a static JSON API, a markdown context pack per harness, and llms.txt. Nothing to install and nothing to send anywhere. Your agent fetches the files and does the matching itself. It covers 14 harnesses.
Pick the harnesses your agent uses
The URLs, the context-pack bundle and the agent rule below are generated for just these. Fewer harnesses means less to download and less context. This starts from the harness selection you made in the paste box on the home page.
1. Static JSON API
Plain files rebuilt nightly. Every file carries schema_version (currently 1) and generated_at. To save bandwidth, fetch only your harnesses' files:
/api/index.json
/api/status.json
/api/issues/<slug>.json/api/index.json: harness list (with status), counts and endpoints/api/status.json: status, its basis and thresholds;/api/history.json: daily open-issue counts/api/issues.json: every tracked issue in one file (681 KB)/llms.txt: an index for LLMs
Each issue carries title, url, state, severity (an automatic estimate, with severity_reasons), versions and error_snippets. When the issue or one of its comments states a fix, it also carries a quoted workaround and a fixed_in version, each with the link it was quoted from.
2. Context packs
Compact markdown for each harness covering top active issues, symptom, versions mentioned, error line and workaround. Paste it into an agent's context or drop it into CLAUDE.md / AGENTS.md. The bundle joins the packs for your selection:
curl -s https://knownfix.ai/context/<slug>.md > knownfix-context.md| Harness | Category | Status | Open | Pack |
|---|---|---|---|---|
| Hermes Agent | open-source harness | ALIVE | 28 | hermes.md 6.8 KB |
| OpenClaw | open-source harness | ALIVE | 28 | openclaw.md 7.4 KB |
| Claude Code | provider harness | ALIVE | 33 | claude-code.md 7.4 KB |
| Codex CLI | provider harness | ALIVE | 24 | codex.md 5.5 KB |
| Gemini CLI | provider harness | ALIVE | 29 | gemini-cli.md 5.7 KB |
| GitHub Copilot CLI | provider harness | ALIVE | 32 | copilot-cli.md 7.0 KB |
| Kiro | provider harness | ALIVE | 31 | kiro.md 6.4 KB |
| Amazon Q Developer CLI | provider harness | ALIVE | 8 | amazon-q-cli.md 4.0 KB |
| OpenCode | open-source harness | ALIVE | 9 | opencode.md 5.7 KB |
| Goose | open-source harness | ALIVE | 32 | goose.md 5.2 KB |
| Cline | open-source harness | ALIVE | 34 | cline.md 6.2 KB |
| Aider | open-source harness | ALIVE | 8 | aider.md 3.3 KB |
| Continue | open-source harness | DOWN | 14 | continue.md 5.6 KB |
| Omarchy | agentic OS | ALIVE | 29 | omarchy.md 6.6 KB |
3. Tell your agent when to use it
Add this to AGENTS.md, CLAUDE.md or your Hermes system prompt. It names the files for your selection:
When a CLI, harness, MCP server or build prints an error, check KnownFix BEFORE trying fixes:
1. Fetch https://knownfix.ai/api/issues/<slug>.json for the harness you are running in.
2. Find issues whose error_snippets or title match the error text.
3. If a match has a quoted workaround, apply it and cite the issue url. If it has fixed_in, say so.
Before upgrading a harness, list the issues in that file whose versions or title mention the target version.Ground rules
- Workarounds and "fixed in" versions are quoted from the issue or its comments, with a link. They are never generated. Check the source before running anything.
- Severity is an automatic estimate, not a vendor rating. Status combines official status pages with an issue-spike heuristic; the explanation says which.
- Matching on this site is lexical (BM25 + sequence matching) and runs in the browser. Treat a low-confidence match as a lead, not an answer.