madelog

Show them how you work with AI. Not just what it built.

madelog records how your project actually came together, decisions, AI sessions, the bugs you caught, and turns it into a page a hiring manager reads in two minutes.

curl -fsSL https://madelog.app/install.sh | sh

Only for one project? Run it inside the repo with --project.

See an example page

An example page

The record of madelog itself, rendered by madelog publish: 27 commits, 9 decisions, 4 moments.

madelog.app/p/quiet-heron-k7m2Open in a new tab

Records itself

Every commit, and every AI session Git AI attributes to it, is written to the log by a git hook. No manual step.

zsh — madelog
curl -fsSL https://madelog.app/install.sh | sh
madelog 0.1.0 for aarch64-apple-darwin
  downloaded madelog-0.1.0-aarch64-apple-darwin.zip, sha256 verified
  installed ~/.local/bin/madelog
  ~/.local/bin is on your PATH

  ┌───┐
  │ ┌─┼─┐   madelog · Proof of Process
  └─┼─┘ │   Records how your project came together.
    └───┘

madelog records three things: the commits you make, the AI sessions Git AI attributes to them, and the one-sentence decisions you write with `madelog note`.
All of it stays on this machine, in .madelog/log.db, until you run `madelog publish`.
No keystrokes, no screenshots, no files git ignores. `madelog export` hands you everything back as JSON.

git      found    /opt/homebrew/bin/git
git-ai   missing  Without it, AI sessions stay empty. Install it from https://github.com/oleander/git-ai
ollama   found    /usr/local/bin/ollama

Set up madelog in this repo now? [Y/n]

One sentence per decision

When you change direction, say why. madelog note pins one sentence to the current commit.

zsh — madelog
madelog note "tried SQLite, moved to Postgres because of concurrent writes"
noted at 3f9c2e1

Publish when you are ready

Review the page in the terminal, hide what you do not want shown, then publish. The badge seals the record.

zsh — madelog
madelog publish
week 1  2026-09-14 to 2026-09-20  (generated)  heuristic
week 2  2026-09-21 to 2026-09-27  (generated)  heuristic
4 moments for the page

madelog  ·  38 entries  ·  2 summaries
j/k move   h hide session   e edit summary   Tab next summary   Enter publish   q abort

page   .madelog/site/index.html
verify https://madelog.app/v1/verify/quiet-heron-k7m2
published  https://madelog.app/p/quiet-heron-k7m2
Send that link. `madelog unpublish` takes it down again.

For whom

If you are applying

Send the process, not a CV. A company sees what you decided, where the AI was wrong and how you caught it.

If you are hiring

The signal Google and HackerRank test for in 2026, on a real project, without a platform contract. Two minutes per candidate.

More in the docs

Privacy

  1. Everything runs on your machine. Without madelog publish, the server does not know the project exists.
  2. Only what you confirm in the preview is uploaded: the rendered page and a 32-byte root hash.
  3. Nothing you record is used to train a model.