The coding session becomes the instruction manual.

Ghost records how real repo work happens, checks it against the code that changed, learns durable developer preferences, and writes those preferences back as rules future coding agents can use.

View GitHub repo Discuss pilot

Evidence IntakeSESSION_20260525

What happened in the room

Ghost samples screen frames from a display or window, deduplicates them, and gives Gemini the visual trail of the session.

frames capped for context, resized before analysis

Gemini Flash analyzesGemini Pro mergesrules regenerate

How It Works

A five-step chain from messy session to portable agent memory.

Open a case

Connect a GitHub repo. Ghost finds the local clone, stores repo metadata, and remembers which rules format that repo wants.

Record the work

Start a short coding session against that repo. Ghost keeps the first git SHA, capture source, session id, and project path together.

Cross-check evidence

After stop, the backend streams progress while it extracts frames, collects chat logs, reads the diff, and asks Gemini for observations.

Update memory

New observations merge into a persistent developer profile and a repo session log instead of becoming one-off chat advice.

Write the verdict

Ghost regenerates `.ghost.md`, `CLAUDE.md`, `.cursorrules`, or `.windsurfrules` so future agent runs inherit the learned pattern.

Persistent StoreSupabase or local filesystem

global_preferenceshabits that repeat across repos

stack_preferencesrules scoped to languages and frameworks

architecture_preferenceslarger choices that shape structure

repo_sessionsevidence history for a connected project

What Ghost Adds

It gives coding agents memory with receipts.

A normal rules file is something a developer writes by hand and forgets to update. Ghost makes it evidence-backed: every preference can come from a recorded session, the agent conversation, and the git diff that proves what changed.

Write Back

One learned profile, many agent surfaces.

.ghost.md

native Ghost rules

CLAUDE.md

Claude-facing guidance

.cursorrules

Cursor defaults

.windsurfrules

Windsurf defaults

Ghost

For teams who want agents to learn from the work, not from a prompt remembered at midnight.

Read the source