devdaily snapshot

Save a snapshot of your current work state to your local journal

Description

Captures and saves a snapshot of your current work state including commits, branches, PRs, tickets, and code changes to a local journal. This builds a searchable history for context recovery and work summaries.

Aliases: snap, save

Usage

devdaily snapshot [options]
# Or use aliases
devdaily snap [options]

Options

-d, --date <date> · string

Snapshot date (YYYY-MM-DD). Default: today

-p, --project <id> · string

Override project identifier (auto-detected from repo by default)

-n, --note <text> · string

Attach a note to this snapshot

-t, --tag <tags...> · string[]

Add custom tags to the snapshot (e.g., “bugfix”, “feature”)

--no-prs · boolean

Skip fetching PR data

--no-tickets · boolean

Skip fetching ticket data

--no-branches · boolean

Skip listing active branches

--light · boolean

Quick snapshot - commits and branch info only (no PRs/tickets)

--debug · boolean

Show detailed debug output

--stats · boolean

Show journal storage stats instead of taking a snapshot

--list [days] · string

List recent snapshots. Default: 7 days

--prune <days> · string

Remove journal entries older than N days

Examples

Take a snapshot now

devdaily snapshot

Add a note

devdaily snapshot --note "Finished OAuth implementation"

Add tags

devdaily snapshot --tag feature --tag auth --tag release-blocker

Quick snapshot (fast mode)

devdaily snapshot --light

Skip external data

devdaily snapshot --no-prs --no-tickets

View recent snapshots

devdaily snapshot --list
devdaily snapshot --list 14  # Last 14 days

View journal stats

devdaily snapshot --stats

Clean old entries

devdaily snapshot --prune 90  # Remove entries older than 90 days

Backdate a snapshot

devdaily snapshot --date 2024-01-15

What Gets Captured

Each snapshot includes:

• Project metadata - Repository name, path, current branch
• Today’s commits - All commits made today with messages and file changes
• Active branches - All local branches with:
  • Commits ahead of base
  • Uncommitted changes
  • Last commit message
• Pull requests - Associated PRs with status
• Tickets - Linked tickets from PM tools
• Diff statistics - Files changed, insertions, deletions
• Work categories - Auto-categorized by file types (frontend, backend, etc.)
• Notes and tags - Custom metadata

Light Mode

Use --light for faster snapshots that skip:

• PR fetching (saves ~1-2 seconds)
• Ticket fetching (saves ~1-3 seconds)
• External API calls

Perfect for git hooks or frequent snapshots.

Journal Storage

Snapshots are stored in:

• Location: ~/.devdaily/journal.json
• Format: JSON
• Size: ~1-5 KB per snapshot

List View

The --list output shows:

• Grouped by date
• Per-project breakdown
• Top commits for each day
• Notes and tags
• Diff statistics

Stats View

The --stats output includes:

• Total snapshots
• Active dates
• Projects tracked
• Oldest and newest entries
• Storage used
• Per-project freshness (days since last snapshot)

Automatic Snapshots

Set up git hooks to automatically snapshot on:

devdaily init --git-hooks

This installs:

• post-commit - Snapshot after each commit
• post-checkout - Snapshot when switching branches

Requirements

• Must be run inside a git repository
• Optional: PM tool integration for ticket context
• Optional: GitHub CLI for PR data