ShareXP

# ShareXP ShareXP is the fix database that knows what doesn't work. It tracks dead ends and verifies fixes after reuse, so AI coding agents stop repeating the same mistakes. ## Install **Claude Code (recommended):** ``` /plugin install sharexp ``` **Other tools:** ```bash npm install -g @willytop8/sharexp npx sharexp quickstart ``` For Cursor, Codex, OpenCode, Gemini CLI, and other MCP-compatible agents, see [docs/AGENT-SETUP.md](docs/AGENT-SETUP.md). ## What it does - **Cross-user remediation memory** — Share verified fixes across your team and the broader community. Resolutions are outcome-verified, not just captured once and forgotten. - **Dead-end tracking** — Record what didn't work, with negative trust deltas. When another user hits the same error, they see "2 people tried solution X and it made things worse." - **Outcome verification and Bayesian trust** — Every fix is scored by how many times it's been reused successfully. Trust scores update as new reuse data arrives. - **MCP-native** — Ships as a Claude Code plugin and a standard MCP server. Works locally by default; publishing requires explicit consent. - **Privacy-first by design** — Credential, PII, and path sanitization happen at the egress chokepoint on your machine before data leaves. The hub re-sanitizes on ingress. ## What's in the seed corpus The `seeds/` directory contains 145 hand-crafted resolutions across flagship debugging patterns (99), Next.js (16), Vite (10), Prisma (10), and Docker (10). A bulk-imported corpus of ~708 additional resolutions from popular OSS repositories is hosted on the hub at `https://sharexp-hub.fly.dev`. ## MCP tools Core tools (always available): - `get_session_warmup_pack` — Call once at session start. Detects your stack and returns up to 20 pre-loaded fixes for common errors in that stack. Hold these in context to skip per-error lookups for the common case (~10x token savings). - `find_similar_resolutions` — Search local and hub resolutions for similar errors. Use `mode='compact'` (default, <200 tokens) for a quick single result, `mode='alternatives'` (<1500 tokens) to compare top-5 options, or `mode='explain'` (<3000 tokens) for full provenance before a high-stakes change. - `search_resolutions_by_description` — Find fixes by describing what you're trying to do - `suggest_proactive_resolutions` — Suggests known pitfalls and prior resolutions based on files currently being edited, even before a failure occurs - `capture_minimal` — Record a fix in 2 fields (`error_text` + `fix_description`); the server derives fingerprint, categories, and affected files automatically - `capture_resolution_candidate` — Record a potential fix locally - `finalize_resolution` — Mark a candidate as verified and optionally publish to the hub - `record_resolution_outcome` — Report reuse success or failure - `record_dead_end` — Track what didn't work and update trust scores - `get_value_report` — View resolution quality metrics and reuse statistics Advanced tools (set `ER_ADVANCED_TOOLS=true` to enable): Chains, anomaly detection, operational signals, CI outcome reporting, strategy analysis, and root-cause labeling. ## Privacy **Public repos only by default.** ShareXP only publishes fixes from public repos. Private repos stay entirely on your machine. No flag to remember — the right behavior is the default. To publish from a private repo, set `SHAREXP_PUBLISH_PRIVATE=true` in your shell or in the mcpServers `env` block. To disable all publishing, set `SHAREXP_NO_PUBLISH=true`. **Identifier-aware redaction.** In addition to credential, PII, and path sanitization, ShareXP now strips CamelCase function names, internal file paths, scoped package names, and repo identifiers from outgoing payloads before transmission. `pull_request_url` is never sent. Repo identifiers are replaced with a 12-char SHA-256 hash prefix. **Verify what's shared.** Use the `get_repo_visibility_status` MCP tool to check your current repo's publishing status before doing sensitive work. See [SECURITY.md](SECURITY.md) and [docs/PRIVACY.md](docs/PRIVACY.md) for the full privacy posture. ## Self-host the hub If you don't trust the hosted hub at sharexp-hub.fly.dev, you can run your own. See [docs/SELF-HOSTING.md](docs/SELF-HOSTING.md). ## Project status ShareXP is an alpha project with a hosted hub on Fly.io, a growing curated seed corpus, and early tooling for outcome verification. We're actively expanding the corpus and looking for early users. ## Links - [Hub API](hub/API.md) - [Hub Operations](hub/OPERATIONS.md) - [Contributing](CONTRIBUTING.md) - [Security](SECURITY.md) - [MIT License](LICENSE)