Skip to main content

acc logs

List and filter your work log entries. Alias: acc ls

Usage​

acc logs [OPTIONS]
acc ls [OPTIONS]    # Short alias

Options​

FlagDescription
-p, --project <PROJECT>Filter by project identifier
-a, --allShow entries from all projects (overrides current project default)
-t, --tags <TAGS>Filter by comma-separated tags
--from <DATE>Start date (inclusive, YYYY-MM-DD format)
--to <DATE>End date (inclusive, YYYY-MM-DD format)
-n, --limit <NUMBER>Maximum number of entries (default: 20)
-v, --verboseShow full entry content instead of truncated preview

Examples​

Recent Entries​

# Show recent entries (uses current project if configured)
acc logs

# Show recent entries from all projects
acc logs --all

Filter by Project​

# Entries from specific project
acc logs -p WEB

# All entries regardless of current project context
acc logs --all

Filter by Tags​

# Entries with specific tags
acc logs -t backend,api

# Entries with any of these tags
acc logs -t bug,fix,hotfix

Date Filtering​

# Entries from today
acc logs --from $(date +%Y-%m-%d)

# Entries from last week
acc logs --from 2025-01-09 --to 2025-01-16

# Entries from specific month
acc logs --from 2025-01-01 --to 2025-01-31

Limit Results​

# Show only 5 most recent entries
acc logs -n 5

# Show 50 entries with full content
acc logs -n 50 -v

Combined Filtering​

# Complex filter: backend entries from WEB project last week
acc logs -p WEB -t backend --from 2025-01-09 --to 2025-01-16 -v

Output Format​

Default (Truncated)​

2025-01-16 14:30  [WEB] Fixed authentication bug in login flow
                  Tags: backend, security, bugfix

2025-01-16 13:15  [API] Updated user profile endpoints  
                  Tags: api, backend, users

2025-01-16 11:45  Deployed v2.1.0 to production environment...
                  Tags: deployment, release

Verbose (-v)​

2025-01-16 14:30  [WEB] Fixed authentication bug in login flow
                  
Fixed critical authentication bug where users couldn't log in 
after password reset. The issue was in the token validation 
logic that wasn't properly handling expired reset tokens.

Changes made:
- Updated TokenValidator to check expiration properly
- Added better error messages for expired tokens  
- Improved logging for debugging auth issues

Tags: backend, security, bugfix
---

Project Context​

By default, logs shows entries based on your current context:

  1. With -p PROJECT: Shows entries from specified project
  2. With --all: Shows entries from all projects
  3. Local project configured: Shows entries from current project
  4. No project context: Shows entries from all projects

Date Format​

All dates use YYYY-MM-DD format:

  • --from 2025-01-16: Start from January 16, 2025
  • --to 2025-01-20: End on January 20, 2025

Tag Filtering​

Tags are matched case-insensitively:

  • -t backend,API matches entries tagged with "backend", "api", "Backend", etc.
  • Multiple tags work as OR (entries with any of the specified tags)

Performance​

  • Default limit of 20 entries for fast loading
  • Use -n to increase limit as needed
  • Date filtering happens server-side for efficiency
  • Tag filtering is optimized for common patterns

Requirements​

  • Must be authenticated (acc login)

Tips​

# Quick aliases for common queries
alias today="acc logs --from \$(date +%Y-%m-%d)"
alias yesterday="acc logs --from \$(date -d yesterday +%Y-%m-%d) --to \$(date -d yesterday +%Y-%m-%d)"
alias thisweek="acc logs --from \$(date -d 'last monday' +%Y-%m-%d)"

# Review your work for standup
acc logs --from $(date -d yesterday +%Y-%m-%d) -v

# Find all bug fixes
acc logs -t bug,bugfix,fix --all -v