# sheal

> Your AI agent keeps making the same mistakes. sheal fixes that.

**Status:** Released | **Language:** TypeScript | **License:** MIT
**Repo:** https://github.com/liwala/sheal

## The Problem

Your AI agent has amnesia. Every session it repeats the same mistakes, burns the same tokens, forgets the same rules.

## What It Does

- Pre-session health checks (git, deps, tests, environment)
- Session retrospectives with failure loop detection
- LLM-enriched deep analysis
- Cross-session search with natural language
- ADR-style learning management
- Token cost dashboards per project, per model
- Weekly reports with digest + cost + analysis
- Interactive TUI browser
- Cross-session knowledge graph

## Quick Start

```bash
git clone https://github.com/liwala/sheal
cd sheal && npm install && npx tsc && npm link

sheal check        # health check your setup
sheal retro        # retrospective on latest session
sheal cost         # token spend dashboard
sheal ask "what went wrong?"  # search sessions
```

**Supports:** Claude Code, Codex, Amp, Cursor, Gemini, Entire.io