Daily Mac Activity Summary - A single-binary macOS CLI that summarizes today's computer activity in a friendly, animated terminal UI.
- Today only, local only, best-effort only - No historical database, no cloud sync, no telemetry
- Uptime & awake time tracking
- Battery usage monitoring
- Top 3 apps by usage time
- Screen-on time calculation
- Focus streak detection
- Browser activity tracking (Chrome, Safari, Edge)
- Open tabs count per browser
- Browser history analysis (today's URLs only)
- Issue/ticket URL detection (Jira, GitHub, Linear, GitLab, Azure DevOps, etc.)
- Most-visited domains
- Now Playing tracking (optional)
- Network activity summary (data transferred, active connection)
- Notification interruptions tracking (total count and top interrupting apps)
brew tap alexinslc/rekap
brew install rekapOr install directly without tapping:
brew install alexinslc/rekap/rekapDownload the latest release for your architecture:
# For Apple Silicon (M1/M2/M3)
curl -L https://github.com/alexinslc/rekap/releases/latest/download/rekap-darwin-arm64 -o rekap
chmod +x rekap
sudo mv rekap /usr/local/bin/
# For Intel Macs
curl -L https://github.com/alexinslc/rekap/releases/latest/download/rekap-darwin-amd64 -o rekap
chmod +x rekap
sudo mv rekap /usr/local/bin/git clone https://github.com/alexinslc/rekap.git
cd rekap
make build
sudo make installrekap # Today's activity summary
rekap init # Permission setup wizard
rekap doctor # Check capabilities and permissions
rekap demo # See sample output with fake data
rekap --quiet # Machine-parsable key=value output
rekap --theme <name> # Use a color theme
rekap --accessible # Accessibility mode (color-blind friendly)
rekap completion <shell> # Generate shell completion script (bash/zsh/fish)rekap supports custom color themes to personalize your output. Choose from built-in themes or create your own:
rekap --theme hacker # Matrix-style green theme
rekap --theme minimal # Grayscale theme
rekap --theme dracula # Dracula color scheme
rekap demo --theme nord # Preview Nord themeBuilt-in themes:
default- Magenta/cyan (current default)minimal- Grayscalehacker- Matrix greenpastel- Soft pastelsnord- Nord color schemedracula- Dracula themesolarized- Solarized dark
Custom themes:
Create your own theme file at ~/.config/rekap/themes/mytheme.yaml:
name: "My Theme"
author: "Your Name"
colors:
primary: "#0077be"
secondary: "#00a8e8"
accent: "#00c9ff"
success: "#00ffa3"
error: "#ff6b6b"
muted: "#6c757d"
text: "#ffffff"Then use it:
rekap --theme mytheme
# or with full path
rekap --theme ~/.config/rekap/themes/mytheme.yamlrekap supports a configuration file at ~/.config/rekap/config.yaml for customizing:
- Color scheme
- Display preferences (show/hide sections)
- Time format (12h/24h)
- Apps to exclude from tracking
- Accessibility features (color-blind friendly mode)
See docs/CONFIG.md for detailed configuration options and examples.
The --quiet flag outputs stable key=value pairs for scripting:
awake_minutes=287
boot_time=1730864122
battery_start_pct=92
battery_now_pct=68
screen_on_minutes=215
top_app_1=VS Code
top_app_1_minutes=142
focus_streak_minutes=87
focus_streak_app=VS Code
browser_total_tabs=24
browser_chrome_tabs=18
browser_safari_tabs=2
browser_edge_tabs=4
browser_urls_visited=147
browser_top_domain=github.com
browser_top_domain_visits=34
browser_issues_viewed=3
network_interface=en0
network_name=Home-5GHz
network_bytes_received=2469606195
network_bytes_sent=471859200
notifications_total=47
notification_app_1=Slack
notification_app_1_count=18
notification_app_2=Mail
notification_app_2_count=12
notification_app_3=Messages
notification_app_3_count=9
rekap supports shell completion for bash, zsh, and fish. To enable completion:
# Generate completion script
rekap completion zsh > ~/.zsh/completion/_rekap
# Or use Homebrew's completion directory (recommended on macOS)
rekap completion zsh > $(brew --prefix)/share/zsh/site-functions/_rekapThen restart your shell or run source ~/.zshrc.
# macOS (with Homebrew's bash-completion)
rekap completion bash > $(brew --prefix)/etc/bash_completion.d/rekap
# Linux
rekap completion bash > /etc/bash_completion.d/rekapThen restart your shell or run source ~/.bashrc.
rekap completion fish > ~/.config/fish/completions/rekap.fishThen restart your shell or run source ~/.config/fish/config.fish.
For more details on each shell's completion, see rekap completion <shell> --help.
rekap works without any permissions but provides more data when granted:
| Permission | Enables |
|---|---|
| Full Disk Access | App usage, screen time, focus streaks, notification tracking |
| Accessibility | Frontmost app detection (fallback) |
| Media/Now Playing | Track currently playing media |
| None required | Browser tabs, uptime, battery, network |
Run rekap init for guided permission setup. Run rekap doctor to check current status.
All data stays on your Mac. No telemetry, no cloud sync, no historical tracking. Only today's activity is analyzed.
- macOS 11.0 or later
Optional permissions for full functionality (use rekap init to set up):
- Full Disk Access - Screen Time database access
- Accessibility - Frontmost app detection (fallback)
- Media/Now Playing - Track playing media
go build -o rekap ./cmd/rekap
./rekap"Screen Time unavailable" message:
- Run
rekap initto set up Full Disk Access - Grant permission to your terminal app in System Settings → Privacy & Security → Full Disk Access
No app data showing:
- Ensure Full Disk Access is granted (run
rekap doctorto check) - Restart your terminal after granting permissions
- macOS Screen Time must be enabled (System Settings → Screen Time)
Binary won't run:
- On first run, right-click the binary and select "Open" to bypass Gatekeeper
- Or run:
xattr -d com.apple.quarantine /usr/local/bin/rekap
Homebrew installation issues:
- Ensure you have the latest Homebrew:
brew update - If the tap isn't found, verify the repository exists at https://github.com/alexinslc/homebrew-rekap
- Try untapping and tapping again:
brew untap alexinslc/rekap && brew tap alexinslc/rekap
Check permissions status:
rekap doctorMIT