Metadata-Version: 2.4
Name: mihver
Version: 0.0.1
Summary: Mihver — AI agent reliability layer. Catches Claude Code skills that should have fired but didn't.
Author-email: Ali Varinlioglu <ali@mihver.ai>
License: Proprietary
Project-URL: Homepage, https://mihver.ai
Project-URL: Issues, https://github.com/quitlo/mihver/issues
Keywords: claude-code,ai-agent,reliability,skills,observability
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Mihver

AI agent reliability layer. Catches Claude Code skills that should have fired but didn't.

This Python package on PyPI is currently a **name-reservation placeholder** (v0.0.1). The full installable package ships at v0.5.0.

## Installation (when shipped)

```bash
pip install mihver           # Python users
brew install mihver/mihver/mihver  # macOS / Homebrew
```

Or download the macOS `.dmg` from https://mihver.ai (drag-and-drop install for non-technical users).

## What Mihver does

Local-first dashboard for Claude Code power users running 10+ personal skills. Reads your session JSONLs from `~/.claude/projects/`, extracts structured signatures from each `SKILL.md` via your local `claude` CLI, and surfaces the gap when a skill should have fired but didn't.

- **Sessions surface**: turn-by-turn timeline with green badges for fired tools and a collapsible list of available-but-unfired skills per turn.
- **Skills surface**: registry of every skill across `~/.claude/skills/` and project-level `.claude/skills/`.
- **Branch + Quick Replay**: pick any turn, edit a skill inline, run replay via `claude -p`, see the decision diff side-by-side, adopt the edit (hash-validated write).
- **Detection classes**: precedence violations (Class A), rule compliance on agent outputs (Class D), composition gaps and pattern drift (V0.5+).

No API key required — Mihver uses your existing Claude Code subscription.

## Status

| Version | Stage | What's included |
|---------|-------|-----------------|
| `v0.0.1` (current) | Name reservation | Placeholder. No functional code. |
| `v0.5.0` (next) | Public beta | Full Python package + `mihver` CLI. Electron `.dmg` + Homebrew formula in parallel. |
| `v1.0.0` (later) | GA | Multi-runtime (Cursor, Cline, Codex CLI, Gemini CLI), team-tier features, hosted layer. |

## Links

- Homepage: https://mihver.ai
- Issues: https://github.com/quitlo/mihver/issues

## License

Proprietary. See [LICENSE](LICENSE). Final license terms determined at v0.5.0 release.
