Skip to main content

​
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)