Metadata-Version: 2.4
Name: agent-dreamer
Version: 0.1.1
Summary: Mine recurring feedback from coding-agent sessions and visualize it.
Project-URL: Homepage, https://github.com/whistler/dreamer
Project-URL: Repository, https://github.com/whistler/dreamer
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: <3.14,>=3.11
Requires-Dist: anthropic>=0.30
Requires-Dist: fastembed>=0.3
Requires-Dist: numba>=0.61
Requires-Dist: numpy>=1.26
Requires-Dist: openai>=1.0
Requires-Dist: pydantic>=2
Requires-Dist: python-fasthtml>=0.12
Requires-Dist: scikit-learn>=1.3
Requires-Dist: tqdm>=4
Requires-Dist: umap-learn>=0.5
Requires-Dist: uvicorn>=0.29
Provides-Extra: dev
Requires-Dist: build>=1; extra == 'dev'
Requires-Dist: pytest>=9; extra == 'dev'
Requires-Dist: twine>=5; extra == 'dev'
Description-Content-Type: text/markdown

# Dreamer

[![PyPI](https://img.shields.io/pypi/v/agent-dreamer)](https://pypi.org/project/agent-dreamer/)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

Stop repeating the same coding-agent corrections.

Most teams give their coding agent the same feedback over and over: verify
builds and tests before declaring done, don't weaken tests to make them pass,
don't add comments nobody asked for, follow the project's naming conventions.
That feedback rarely makes it into `AGENTS.md` or `CLAUDE.md`, so the agent
keeps making the same mistakes.

Dreamer mines your recent coding-agent session history for the corrections
that keep recurring, and turns them into concrete additions to your context
files, with the original conversation as evidence and your approval required
before anything is written.

Dreamer works with **20 coding harnesses** including Claude Code, Codex,
Cursor, OpenCode, Gemini CLI and more.

```text
session history -> recurring corrections -> context file updates -> fewer repeated corrections
```

## Get started

Requires Python 3.11-3.13.

```bash
npx skills add whistler/dreamer --skill dream -g -y
```

Then, in your agent:

```text
/dream
/dream --days 14
```

Dreamer proposes context-file updates as a reviewable in-chat plan (instructions,
supporting evidence, and destination files) and applies only what you approve.

No provider keys needed; Dreamer uses your existing subscription. Everything
runs locally: session history is read on your machine, context files are
edited on your machine, and nothing is uploaded. Session history comes from
[`cass`](https://github.com/Dicklesworthstone/coding_agent_session_search),
which Dreamer installs automatically on first run.

## The dashboard

For reviewing patterns, evidence, and trends across many sessions at once, use
the dashboard:

```bash
pipx install agent-dreamer
dreamer serve
```

If you want the CLI to mine sessions without the `/dream` skill, run
`dreamer run --yes` after configuring a provider key.

## See it in action

**Patterns** turn repeated corrections into candidate context improvements with
evidence attached.

![Dreamer feedback view](https://raw.githubusercontent.com/whistler/dreamer/main/assets/dreamer-feedback.png)

**Clusters** show where your agent work is concentrated and which kinds of
tasks keep recurring.

![Dreamer clusters view](https://raw.githubusercontent.com/whistler/dreamer/main/assets/dreamer-clusters.png)

**Stats** show activity trends, project volume, and how your workflow changes
over time.

![Dreamer stats view](https://raw.githubusercontent.com/whistler/dreamer/main/assets/dreamer-stats.png)

## Supported coding harnesses

Dreamer works with 20 coding harnesses via `cass`:

`Codex`, `Claude Code`, `Gemini CLI`, `Cline`, `OpenCode`, `Amp`, `Cursor`,
`ChatGPT`, `Aider`, `Pi-Agent`, `GitHub Copilot Chat`, `Copilot CLI`,
`OpenClaw`, `Clawdbot`, `Vibe`, `Crush`, `Hermes`, `Kimi Code`, `Qwen Code`,
and `Factory (Droid)`.

## Learn more

- [Dream skill details](docs/skill.md)
- [Architecture](docs/architecture.md)
- [Research papers](docs/research-papers.md)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).
