Skip to main content

Mine recurring feedback from coding-agent sessions and visualize it.

Project description

Dreamer

PyPI License: MIT

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.

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

Get started

Requires Python 3.11-3.13.

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

Then, in your agent:

/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, which Dreamer installs automatically on first run.

The dashboard

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

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

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

Dreamer clusters view

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

Dreamer stats view

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

Contributing

See CONTRIBUTING.md.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_dreamer-0.1.1.tar.gz (2.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent_dreamer-0.1.1-py3-none-any.whl (52.1 kB view details)

Uploaded Python 3

File details

Details for the file agent_dreamer-0.1.1.tar.gz.

File metadata

  • Download URL: agent_dreamer-0.1.1.tar.gz
  • Upload date:
  • Size: 2.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for agent_dreamer-0.1.1.tar.gz
Algorithm Hash digest
SHA256 2dbb67c240d922c474b74759476b18190af27b0b9f71be18256ff3cccf790298
MD5 c6efc779cc85bf4cd148e22a4ab7d6c3
BLAKE2b-256 bfe447bec51d6eb5ccfb1bc828ead1e5858ed49869d204b596254875e496cd3f

See more details on using hashes here.

File details

Details for the file agent_dreamer-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: agent_dreamer-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 52.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for agent_dreamer-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8c39c76f0bdfdd791f6fe203a760bd17dc83b03b013d94848d15a49bcfef1e0b
MD5 c77f3e5da74277a5dfb7f8bdff722d63
BLAKE2b-256 b53b005556120791147c430a241d1843308fb6f28d6a6a4b0482a08b9433286b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page