conversate.sidocs
conversate-cli v0.2.1

Introducing the Conversate CLI

A personal harness for Claude Code that learns from your folder and your conversations.

++++
~/my-project
➜npx conversate-cli init
Found: 63 files: 24 code, 19 documents, 12 notes
User: unknown (will be learned)
✓ Harness scaffolded. It knows only what the scan found.
➜claude “what does app.py do?”
…answers your question, then:
I saved 4 facts to the harness: what the project is, the pipeline status, what app.py does, and the current task. Tell me if any are wrong.
➜npx conversate-cli status
Bootstrap: ✓ done · Hooks: ✓ SessionStart + Stop
Memory: 4 active (L2 Project 3 · L5 Working 1)

What it does

Claude Code reads CLAUDE.md at the start of every session. Conversate keeps a section of that file current with what Claude has learned about you and your work, so you stop re-explaining yourself. It works for any folder: a code repository, university applications, research, client work.

What makes it different

  • Nothing is assumed. init records only what it can see in the folder. Who you are and what you are doing is learned from you.
  • It learns while you work. Claude saves preferences, facts, decisions and mistakes as they come up, and tells you what it saved so you can correct it.
  • It's all plain files on your disk. Everything is in .conversate/ and CLAUDE.md. Read it, edit it, delete it. No account, no server.
Supported today: Claude Code on macOS and Linux, Node.js 18+. Codex, Cursor and other agents are not supported yet.

Get started in any folder:

bash
npx conversate-cli init