git404hub

what is dreamer fr?

whistler/dreamer — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A tool that mines your coding agent's session history for repeated corrections and turns them into reviewable additions to files like AGENTS.md or CLAUDE.md.

vibe map

mindmap
  root((Dreamer))
    What it does
      Mines recurring corrections
      Proposes context updates
      Requires user approval
    How it works
      Reads session history
      Uses cass tool
      Local only
    Extras
      Dashboard
      Pattern clusters
    Audience
      Coding agent users
      Dev teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Stop a coding agent from repeating the same correction by turning it into a CLAUDE.md or AGENTS.md rule.

VIBE 2

Review a proposed context-file update with the original conversation as evidence before approving it.

VIBE 3

Use the dashboard to see clusters of recurring task types across many coding agent sessions.

VIBE 4

Run /dream inside a supported coding agent to mine the last N days of session history.

what's the stack?

Python

how it stacks up fr

whistler/dreamer0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultyeasyeasyhard
Complexity2/52/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires Python 3.11-3.13, installed as a skill via npx into a supported coding agent.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Dreamer is a tool built to stop coding agents from repeating the same mistakes. Many teams find themselves giving their AI coding assistant the same corrections over and over, things like verifying that tests actually pass before saying a task is done, not weakening tests just to make them pass, or following naming conventions the project already has. That kind of feedback often never makes it into a project's shared instruction files, so the agent keeps making the same errors in future sessions. Dreamer solves this by mining a user's recent coding agent session history for corrections that keep showing up again and again, then turning those patterns into concrete suggested additions to instruction files like AGENTS.md or CLAUDE.md. It presents each suggestion along with the original conversation as evidence, and nothing is written to a file until the user reviews and approves it. The tool supports 20 different coding agent tools, including Claude Code, Codex, Cursor, OpenCode, and Gemini CLI, by reading session history through a separate tool called cass, which Dreamer installs automatically the first time it runs. Getting started requires Python 3.11 through 3.13. It is installed as a skill inside a coding agent using a single command, after which running a slash command like /dream inside that agent triggers the analysis and proposes an in chat plan of changes for review. No external API keys are needed since Dreamer uses the coding agent's existing subscription, and everything runs locally: session history is read and context files are edited entirely on the user's own machine, with nothing uploaded elsewhere. For a broader view across many sessions, Dreamer also offers a dashboard that can be installed separately and run as a local web server. This dashboard shows recurring correction patterns with supporting evidence, clusters of where agent work concentrates, and statistics on activity trends over time. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Install the dream skill in my coding agent and run /dream to find recurring corrections from my last 14 days of sessions.
prompt 2
Explain how Dreamer turns repeated agent corrections into proposed additions to my CLAUDE.md file.
prompt 3
Walk me through installing agent-dreamer with pipx and starting the dreamer serve dashboard.
prompt 4
Help me review a Dreamer-proposed context file change and decide whether the evidence supports approving it.

Frequently asked questions

what is dreamer fr?

A tool that mines your coding agent's session history for repeated corrections and turns them into reviewable additions to files like AGENTS.md or CLAUDE.md.

What language is dreamer written in?

Mainly Python. The stack also includes Python.

What license does dreamer use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is dreamer to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is dreamer for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.