Skip to content

Y

Y is a tool for understand why and how code was built; specifically by AI Agents.

Code Video Cerebral Valley

Core trick

Reads sanitized Codex session logs and attaches per-commit summaries to git notes, so history is stored inside the existing repository.

Tags

dev tools

Description

Y is a tool for understand why and how code was built; specifically by AI Agents. We are suffering from a proliferation of code and inability to review code we no longer write ourselves. OSS maintainers are closing PRs generated by the community. Y generates enriched provenance from coding agent logs. It integrates with git notes to embed directly within developer workflows. Under the hood, Y uses Codex to generate the enriched summary per commit. Try Y today: y <commit-hash>
eqtylab/y★ 110 forksRustApache-2.0Created Feb 5, 2026 · last push Feb 6, 2026

README excerpt

# y

`y` answers "why".

## Overview

`y` is a tool for preserving agent intent, decisions, and tribal knowledge accumulated while using coding agents, all in your existing git repository, no out-of-band databases!

`y` currently supports automated tracking of sanitized Codex session logs, session summaries, and "vibe provenance" while using Codex CLI and/or the Codex desktop app.

## Quick Start

```bash
# install y
cargo install --git https://github.com/eqtylab/y y

# setup y (in your git repo)
y init

# after running `y init`, vibe provenance will now be logged as git notes in your repo

# to view notes for last 10 commits
y notes list --last 10

# to open interactive GUI to view insights for a specific commit
y notes ui --commit <commit_hash>
```

## Repo layout

- `y/`: core CLI
- `y-schema/`: SummaryRoot schema + validation
- `y-skills/`: Codex skills for session log and summary generation
- `y-ui/`: summary viewer app scaffold

## Justfile

```present just --list
Available recipes:
    ci            # Primary CI entry point.
    readme-check  # Render README and fail if checked-in content is stale.
    readme-update # Regenerate README content in place from present blocks.
```

## CLI Usage

```present cargo run -p y -- --help
y CLI

Usage: y <COMMAND>

Commands:
  init      Initialize y in the current repository
  commit    Print summary note content for a commit
  notes     Manage notes attached to commits
  validate  Validate artifacts against y-schema
  summary   C

Team