Skip to main content

acc recap

Experimental Feature

This command is currently experimental, not guaranteed to work properly, and may change in future versions.

Generate AI-powered summaries of your work log entries.

Usage​

acc recap [OPTIONS]

Options​

FlagDescription
--from <DATE>Start date (inclusive, YYYY-MM-DD format)
--to <DATE>End date (inclusive, YYYY-MM-DD format)
--since <PERIOD>Look back from now by duration (e.g., "24h", "3h30m", "2d", "1w")
-t, --tags <TAGS>Filter by space-separated tags
-x, --exclude-tags <TAGS>Exclude entries that have any of these tags
-p, --project <PROJECT>Filter by project identifier (uses current project by default)

Examples​

Basic Recap​

# Generate recap for current project (if configured)
acc recap

# Recap for specific project
acc recap -p WEB

Time-based Recaps​

# Last 24 hours
acc recap --since 24h

# Last week
acc recap --since 1w

# Specific date range
acc recap --from 2025-01-09 --to 2025-01-16

Tag Filtering​

# Only include backend work
acc recap -t backend api database

# Exclude meetings and admin work
acc recap -x meeting admin standup

# Focus on specific feature development
acc recap -t feature frontend user-auth

Combined Filtering​

# Last week's backend work, excluding meetings
acc recap --since 1w -t backend api -x meeting

# Specific project and timeframe
acc recap -p API --from 2025-01-01 --to 2025-01-31 -t performance

Time Period Format​

The --since option accepts various time formats:

  • Hours: 24h, 3h30m, 1.5h
  • Days: 1d, 7d, 2d
  • Weeks: 1w, 2w
  • Mixed: 1w2d3h (1 week, 2 days, 3 hours)

Sample Output​

# Work Summary: January 9-16, 2025
## Project: Web Application (WEB)

### Key Accomplishments
- **Authentication System**: Implemented comprehensive user authentication with JWT tokens, password reset functionality, and session management
- **Frontend Enhancement**: Redesigned user dashboard with improved UX, responsive design, and accessibility features  
- **Performance Optimization**: Reduced API response times by 40% through database query optimization and caching implementation

### Bug Fixes & Maintenance
- Resolved critical login issue affecting Safari users
- Updated security dependencies and fixed vulnerability in user input validation
- Improved error handling and logging throughout the application

### Development Metrics
- **Total Entries**: 23 work log entries
- **Primary Focus Areas**: Backend (60%), Frontend (30%), DevOps (10%)
- **Most Active Days**: Monday-Wednesday with consistent progress on core features

### Upcoming Priorities
Based on recent work patterns, consider focusing on:
- Completing user profile management features
- Planning deployment pipeline improvements
- Addressing remaining UI/UX feedback from stakeholder review

AI Summary Features​

The AI-powered recap includes:

  • Key Accomplishments: Major features and milestones
  • Bug Fixes & Maintenance: Issue resolution and technical debt
  • Development Patterns: Time allocation and focus areas
  • Metrics: Quantitative analysis of your work
  • Future Recommendations: Suggested next steps

Tag Strategy​

For best results, use consistent tagging:

# Include productive work
acc recap -t feature bugfix performance optimization

# Exclude non-development activities  
acc recap -x meeting admin planning review

Project Context​

  • With -p PROJECT: Recaps specific project
  • Current project configured: Uses your default project
  • No project context: Includes all projects (may be less focused)

Best Practices​

Weekly Reviews​

# Monday morning: recap last week
acc recap --since 1w -x meeting

# Friday afternoon: recap this week
acc recap --since $(date -d 'last monday' +%Y-%m-%d)

Feature Development​

# Track progress on specific feature
acc recap -t user-auth authentication login

# Review bug fixing efforts
acc recap -t bug bugfix hotfix --since 1w

Performance Analysis​

# Focus on technical work
acc recap -t backend api database performance -x meeting admin

# Review specific time period
acc recap --from 2025-01-01 --to 2025-01-31

Requirements​

  • Must be authenticated (acc login)
  • Requires at least one work log entry in the specified time range
  • AI summary generation requires network connectivity

Notes​

  • Summaries are generated server-side using AI
  • Processing time increases with more entries (typically 5-15 seconds)
  • Recaps are not stored; generate fresh summaries as needed
  • Works best with descriptive, detailed work log entries