ddday

Daily work journal + machine migration toolkit for AI-assisted workflows.

Auto-scans all registered projects (git activity, file changes), generates a daily HTML dashboard and markdown logs, and provides one-command data export/restore for seamless machine migration.

What it does

• Daily scanning — Tracks git commits, uncommitted changes, and file activity across all your projects
• HTML dashboard — Generates a minimal, dark/light theme dashboard with project cards
• Markdown logs — Daily logs/YYYY-MM-DD.md files for AI context
• Work snapshot — Self-contained markdown file that any AI can read to instantly understand all your work
• Migration export — One command packs everything (logs, config, credentials, AI memory) into a portable bundle
• New machine restore — One command unpacks, remaps paths, installs deps, and registers cron
• Health check — Verifies project paths, dependencies, cron jobs, and path consistency

Quick Start

# 1. Clone
git clone https://github.com/zhengdechang/ddday.git ~/Desktop/ddday

# 2. Register your projects
cp workspace.example.json workspace.json
# Edit workspace.json with your project paths

# 3. Register as Claude Code skill
ln -sfn ~/Desktop/ddday ~/.claude/skills/ddday

# 4. Run
python3 generate_dashboard.py
open dashboard.html

# 5. (Optional) Set up daily cron
chmod +x run_ddday.sh
(crontab -l 2>/dev/null; echo "2 18 * * * ~/Desktop/ddday/run_ddday.sh") | crontab -

Commands

Command	Description
/ddday	Scan all projects, generate daily log + dashboard
/ddday add <path>	Register a new project
/ddday context	Generate AI context pack
/ddday snapshot	Full work snapshot for AI handoff
/ddday export	One-command migration bundle
/ddday doctor	Environment health check
/ddday log	View latest daily log
/ddday status	Quick project status

Machine Migration

Old machine

python3 export.py
# Creates ~/Desktop/ddday-migration-YYYY-MM-DD.tar.gz

New machine

tar xzf ddday-migration-*.tar.gz
cd ddday-migration
cat READ-ME-FIRST.md    # AI reads this to understand all your work
bash setup.sh           # Auto-restore (path remap, deps, cron, symlinks)
python3 doctor.py       # Health check

File Structure

ddday/
├── SKILL.md                # Skill definition (Claude Code / OpenClaw)
├── workspace.json          # Your project registry
├── generate_dashboard.py   # Dashboard + log generator
├── work_snapshot.py        # Full work context snapshot
├── export.py               # Migration bundle creator
├── setup.sh                # New machine restore
├── doctor.py               # Health check
├── run_ddday.sh            # Cron entry point
├── dashboard.html          # Latest dashboard (generated)
├── logs/                   # Daily markdown logs
└── context/                # AI context files
    ├── projects-overview.md
    └── LATEST-SNAPSHOT.md

Install via ClawHub

clawhub install ddday

License

MIT