hyp difflog_en.md

hyp diff-log — AI Change Tracking

v0.8.5+ This command is a new feature added in HypGo v0.8.5 and is not available in v0.8.1.

Record all AI (or human) changes to the project in a daily log file. Toggle on/off — when off, saves tokens; when on, tracks the full process.

Usage

hyp diff-log            # Record current uncommitted changes
hyp diff-log --on       # Enable tracking (AI tools will auto-log)
hyp diff-log --off      # Disable tracking (saves tokens)
hyp diff-log --status   # Show current setting

Flags

Flag	Description
--on	Enable diff-log, write to .hyp/config.json
--off	Disable diff-log
--status	Show current on/off state
(no flag)	Execute one recording

Log Output Location

logs/ai.diff_20260410.log

One file per day. Multiple recordings on the same day append to the same file.

Toggle Mechanism

Setting stored in .hyp/config.json (project-level):

{
  "diff_log": true
}

When ON

hyp ai-rules generated AGENTS.md includes:

- After making changes: Run `hyp diff-log` to log your changes

All AI tools see this instruction and auto-run hyp diff-log after modifications.

When OFF

AGENTS.md does NOT include the instruction — AI doesn't know to log, saving ~20 tokens/interaction.

Recommended Workflow

# Early development: enable tracking
hyp diff-log --on
hyp ai-rules              # Update AI config files

# Stable phase: disable to save tokens
hyp diff-log --off
hyp ai-rules              # Remove tracking instruction

# Ad-hoc check
hyp diff-log              # Manual one-time recording regardless of setting

Related Commands

• hyp ai-rules — Generate AI config files (affected by diff-log setting)
• hyp impact — Analyze change impact before modifying