devdaily week

Generate weekly work summaries from commits, PRs, tickets, and journal history

Description

Generates comprehensive weekly work summaries by analyzing git history, pull requests, tickets, and journal snapshots. Supports both single-project and cross-project summaries.

Aliases: w, weekly

Usage

devdaily week [options]
# Or use aliases
devdaily w [options]

Options

-l, --last · boolean

Generate summary for last week instead of current week

-s, --start <date> · string

Custom start date in YYYY-MM-DD format

--from <date> · string

Start date for custom range (YYYY-MM-DD)

--to <date> · string

End date for custom range (YYYY-MM-DD)

-w, --weeks-ago <number> · string

Number of weeks ago (e.g., 2 = two weeks back)

--all-projects · boolean

Include all tracked projects from journal (cross-project summary)

-p, --project <id> · string

Filter by specific project identifier

--no-tickets · boolean

Skip fetching closed tickets/issues

--no-prs · boolean

Skip fetching PR context

--no-journal · boolean

Skip journal data (use only live git data)

--no-auto-snapshot · boolean

Skip auto-saving a snapshot to the journal

--no-copy · boolean

Do not copy to clipboard

--save · boolean

Save the generated summary to the journal as an AI summary

--debug · boolean

Show the full context and prompt sent to Copilot

--raw-context · boolean

Output only the raw context block (no AI generation)

--json · boolean

Output stats as JSON (no AI generation)

Examples

Current week summary

devdaily week

Last week

devdaily week --last

Custom date range

devdaily week --from 2024-01-01 --to 2024-01-07

Two weeks ago

devdaily week --weeks-ago 2

Cross-project summary

devdaily week --all-projects

Save to journal

devdaily week --save

JSON output for processing

devdaily week --json > weekly-stats.json

Specific project only

devdaily week --project my-api

Output Sections

Single-Project Mode

• Accomplishments - Key work completed
• In Progress - Active work and open PRs
• Key Metrics - Lines changed, files touched, PRs merged
• Notable Items - Breaking changes, features, refactors

Cross-Project Mode

• Week Overview - High-level themes across projects
• Per-Project Highlights - Summary for each project
• Cross-Cutting Themes - Patterns across projects
• This Week in Numbers - Aggregate statistics

Journal Integration

The week command combines:

1. Live Git Data - Current commits, PRs, and tickets
2. Journal History - Saved snapshots from previous days

This provides continuity and shows work progression over time.

Configuration

Relevant config settings:

• git.defaultBranch - Base branch for comparisons
• week.startDay - Week start day (monday/sunday)
• output.copyToClipboard - Auto-copy behavior
• output.showStats - Display statistics

Requirements

• Git repository (unless using --all-projects)
• GitHub Copilot CLI (unless using --json or --raw-context)
• Journal snapshots for historical context (optional)