MisakaNet
MisakaNet is a git-backed, searchable knowledge base of verified failure-recovery lessons for AI coding agents. It solves the problem of agents repeatedly debugging the same errors by providing a quick lookup of known fixes. It is for developers and AI agents using tools like Claude Code, Cursor, or Codex.
✨ Key features
- MCP server with 7 tools for search, lessons, intake
- Zero-dependency BM25 keyword search
- Evidence levels E0-E4 for lesson verification
- Multiple integration surfaces: CLI, Python, MCP, WebMCP
- No-account remote MCP intake for agents
- Agent compatibility with Claude Code, Codex, Cursor, etc.
🎯 Use cases
- Search for known fixes when an agent hits an error
- Submit a failure report when no lesson exists
- Integrate failure memory into coding agents via MCP
- Use as a debugging reference in scripts or notebooks
📦 Installation
🧰 Requirements: Python 3 for local MCP or CLI; no account needed for remote MCP; optional registration for unlimited remote access.
curl -sS https://misakanet.org/mcp ...git clone https://github.com/Ikalus1988/MisakaNet.git && cd MisakaNet
python3 scripts/mcp_server.pypip install misakanet
misakanet "database is locked"pip install misakanet-core🚀 Usage
from misakanet.search import search_lessons
results = search_lessons("pip install timeout")
for r in results:
print(r["title"], r["score"])
⚠️ Good to know
WebMCP is a Developer Preview requiring a WebMCP-capable browser agent; anonymous browser agents share a 5 free reads/day quota.
❓ FAQ
Do I need an account to use MisakaNet?
No, the remote MCP endpoint allows anonymous search and intake without an account. Registration is only needed for unlimited remote access.
What are evidence levels?
Lessons are rated E0-E4 based on verification source: E0 community reported, E1 CI verified, E2 PR merged, E3 maintainer verified, E4 production proven.
Can I submit a failure lesson without a GitHub account?
Yes, agents can use the misakanet_submit_intake tool via remote MCP to submit a redacted intake, which becomes a maintainer-visible GitHub issue.
Is MisakaNet a vector database?
No, it uses BM25 keyword search with zero dependencies, not a vector database or RAG system.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.