petit-poucet

Leaves pebbles so your coding agents find their way back.

In the French tale, Le Petit Poucet drops white pebbles along the path to find his way home. petit-poucet keeps a small, curated memory of your rules, decisions and verified facts, so every new session in Claude Code or GitHub Copilot CLI starts where the last one left off.

Install View on GitHub

What your agent sees

At the start of every session, your preferences and the current repo's notes, one line each. The agent opens only the notes a task needs.

🪨 petit-poucet · 20 notes loaded (preferences + chargepath-api)

## Preferences (all repos)
- [[Preferences/commit-rules]] — commit locally per step, never push
- [[Preferences/never-read-secrets]] — pipe secret values, never print them

## Projects / chargepath-api
- [[Projects/chargepath-api/prod-db-no-postgis]] — spatial queries must work without PostGIS

Topics (searched on demand): homelab (8), work-mac (3)

One memory, your rules

Plain Markdown

A folder of short notes you can read and edit in Obsidian or any editor. No database, no cloud.

Curated, not recorded

Agents save a decision, a correction or a verified fact on purpose, with its source. Nothing is scraped from transcripts.

Your rules stay yours

Rules you stated are never changed or deleted without your confirmation, and your own edits are never overwritten.

Every change in git

The vault is a git repository with a local commit after each change: inspect or undo any agent edit.

Shared across agents

Claude Code and Copilot CLI read and write the same memory, per repo, with topics for everything else.

One small binary

A Rust MCP server plus session hooks, installed as a plugin. No runtime, no service to run.

How it works

Claude Code ─┐
Copilot CLI ─┼─ MCP tools + hooks ─▶ petit-poucet ─▶ ~/agent-memory/ (Markdown + git)
other MCP   ─┘                                       ├─ Preferences/       every repo
                                                     ├─ Projects/<repo>/   that repo
                                                     └─ Topics/<topic>/    searched on demand

Two skills come with it: migrate-memory moves your older file-based agent memory in, and tidy-memory has a subagent propose merges and fixes for you to confirm.

Install

Claude Code

claude plugin marketplace add https://github.com/areguig/petit-poucet
claude plugin install petit-poucet@petit-poucet

GitHub Copilot CLI

copilot plugin marketplace add areguig/petit-poucet
copilot plugin install petit-poucet@petit-poucet

macOS or Linux, with git and curl. Start a new session: the agent offers to create your vault in ~/agent-memory.