Metadata-Version: 2.4
Name: shardstitch
Version: 0.0.14
Summary: ShardStitch — capture your AI coding session (git diff, dependency graph, intent) and stitch it into the next tool. 23 AI tools supported. 100% local, zero telemetry. https://shardstitch.com
Author-email: ShardStitch <support@shardstitch.com>
License: Proprietary
Project-URL: Homepage, https://shardstitch.com
Project-URL: Documentation, https://shardstitch.com/start
Project-URL: Repository, https://github.com/shardstitch/shardstitch
Project-URL: Issues, https://github.com/shardstitch/shardstitch/issues
Project-URL: Changelog, https://github.com/shardstitch/shardstitch/releases
Project-URL: X / Twitter, https://x.com/ShardStitch
Project-URL: VS Code Extension, https://marketplace.visualstudio.com/items?itemName=shardstitch.shardstitch
Project-URL: Cursor Extension, https://marketplace.visualstudio.com/items?itemName=shardstitch.shardstitch
Keywords: ai,claude,cursor,codex,gemini,context,handoff,rate-limit,developer-tools
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: docs
Requires-Dist: pypdf>=3.0; extra == "docs"
Requires-Dist: python-docx>=1.0; extra == "docs"
Requires-Dist: openpyxl>=3.1; extra == "docs"
Requires-Dist: beautifulsoup4>=4.12; extra == "docs"
Provides-Extra: pdf-fast
Requires-Dist: pymupdf>=1.23; extra == "pdf-fast"

# ShardStitch

**3:47pm. Mid-refactor. "Rate limit reached."**

Your code is half-written. Your plan is in your head. ShardStitch captures your entire session — git diff, changed files, dependency graph, intent — and stitches it into the next AI tool. Keep building like nothing happened. Works *after* you're locked out, when most tools can't.

## Install & activate

```bash
pip install shardstitch              # install the launcher
shardstitch install <your-license-key>   # download + activate (key from your purchase email)
shardstitch                          # launch the local dashboard at localhost:8765
```

One-time purchase, no subscription. The download is verified by SHA-256 before it ever runs. Get a key at https://shardstitch.com.

## What it does

When Claude, Cursor, Codex, or Gemini locks you out mid-session, ShardStitch:

1. **Scans your project** — git diff, changed files, recent commits, your notes
2. **Builds a dependency graph** — impact radius, god nodes — and warns the next AI what's dangerous to touch
3. **Generates a continuation prompt** formatted for the target tool
4. **Injects it** into the tool's pickup file (CLAUDE.md, AGENTS.md, GEMINI.md, .cursorrules)

Under 30 seconds, end to end. Reads disk, not the dead AI session — so it works after a rate limit, context overflow, or crash.

## Meet Hivy — the on-device layer

Hivy is a hive of small local models that pre-process every session before any big AI sees it. It runs on your machine, so it's there exactly when the rate-limited model isn't.

- **Trims the context** — Hivy returns only the relevant slice of your project instead of dumping everything. **94% fewer tokens, measured on a real repo** — not a borrowed study.
- **Knows when to spend** — the Oracle Router answers easy questions on a free local model and sends only the hard ones to a paid one. Base-plan tokens, pro-plan results.
- **Catches the drift** — Hivy filters off-task tangents so the handoff carries the work, not the noise.

## 3 retrieval tiers

Pick the depth the work needs — each ships with Hivy:

| Tier | Engine | Hivy |
|------|--------|------|
| **Base** | BM25, zero deps | heuristic |
| **RRF** | BM25 + embeddings + fusion | trained (full cascade) |
| **Local LLM** | answers generated locally via Ollama | + your own cloud key for hard queries |

## 23 supported AI tools

Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI, Windsurf, Aider, Kiro, Amazon Q Developer, DeepSeek, OpenCode, Trae, Factory Droid, OpenClaw, Amp, Cline, Roo Code, Kilo Code, Crush, Kimi, Qwen Code, Antigravity, and Grok.

## 7 surfaces

- **Web dashboard** — chat (Normal) + full dashboard (Expert)
- **VS Code / Cursor extension** — Alt+G hotkey
- **MCP server** — 27 tools; Claude Code, Cursor, Windsurf call it directly
- **CLI** — `shardstitch` from any project folder
- **Desktop app** — standalone Windows + Linux exe (Mac coming soon)
- **Autosave hooks** — auto-capture on session end
- **Local LLM failover** — Ollama, vLLM, LM Studio (zero cloud)

## Key features

- **Per-agent formatting** — one handoff shape per supported tool
- **Oracle Router** — routes cheap queries local, hard ones to your cloud key
- **Persistent memory** — project decisions survive across sessions
- **Session Vault** — always-on local recovery history
- **Hash-chained audit trail** — append-only SHA-256 timeline (tamper-detecting)
- **Dependency graph** — impact radius + god-node detection

## Local by default

Your code stays on your machine. No telemetry, no cloud sync. License validation goes to Polar at activation and during a quiet periodic re-check — that's the only routine network call. A cloud LLM you configure is used only when you explicitly enable it.

## Links

- Website: https://shardstitch.com
- GitHub: https://github.com/shardstitch/shardstitch
- X / Twitter: https://x.com/ShardStitch
- Support: support@shardstitch.com
