- version
- 2.0.0
- name
- deepfocus
- description
- Run Pomodoro sessions with break timers and productivity tracking. Use when starting focus sessions, tracking streaks, reviewing productivity.
Deepfocus
Deepfocus v2.0.0 — a productivity toolkit for managing tasks, plans, reviews, streaks, reminders, and more from the command line.
Commands
Run via: bash scripts/script.sh <command> [args]
| Command | Description |
|---|---|
add <input> | Add a new entry (task, note, idea). Without args, shows recent entries. |
plan <input> | Create or view plan entries for organizing your day/week. |
track <input> | Track progress on goals, habits, or tasks. |
review <input> | Log review notes — reflect on what went well or needs improvement. |
streak <input> | Record streak data for habit tracking and consistency. |
remind <input> | Set reminders and notes for future reference. |
prioritize <input> | Mark and log priority levels for tasks. |
archive <input> | Archive completed or outdated entries. |
tag <input> | Tag entries with labels for easy categorization. |
timeline <input> | Add timeline entries for chronological tracking. |
report <input> | Generate or log report entries for summaries. |
weekly-review <input> | Log weekly review notes for end-of-week reflection. |
stats | Show summary statistics across all entry types. |
export <fmt> | Export all data in json, csv, or txt format. |
search <term> | Search across all log files for a keyword. |
recent | Show the 20 most recent activity entries from the history log. |
status | Health check — version, data directory, entry count, disk usage. |
help | Show the built-in help message with all available commands. |
version | Print the current version (deepfocus v2.0.0). |
Each data command (add, plan, track, etc.) works in two modes:
- With arguments: saves the input with a timestamp to its dedicated log file.
- Without arguments: displays the 20 most recent entries from that log.
Data Storage
All data is stored locally in ~/.local/share/deepfocus/:
- Each command has its own log file (e.g.,
add.log,plan.log,track.log) - Entries are saved in
timestamp|valueformat - A unified
history.logrecords all activity across commands - Export files are written to the same directory
Requirements
- Bash (standard system shell)
- No external dependencies — uses only coreutils (
date,wc,du,grep,tail,cat)
When to Use
- When you need to quickly add tasks, plans, or notes from the terminal
- To track daily habits and maintain productivity streaks
- For end-of-day or weekly reviews and reflections
- To set reminders and prioritize tasks without leaving the command line
- To search through past entries by keyword
- To export your productivity data for analysis or backup
- When you want a lightweight, file-based focus and task management system
Examples
# Add a task
deepfocus add "Write unit tests for the auth module"
# Create a plan for the day
deepfocus plan "Morning: deep work on API refactor. Afternoon: PR reviews."
# Track a habit
deepfocus track "Completed 45-minute focus session on documentation"
# Log a review
deepfocus review "Good progress on backend. Need to speed up frontend work."
# Record a streak
deepfocus streak "Day 15 of daily coding — still going strong"
# Set a reminder
deepfocus remind "Submit expense report by end of week"
# Prioritize a task
deepfocus prioritize "P0: Fix production memory leak"
# Archive an old entry
deepfocus archive "Q3 planning notes — no longer relevant"
# Tag an entry
deepfocus tag "meeting-notes: Sprint retrospective takeaways"
# Add to timeline
deepfocus timeline "Shipped v2.0 release to production"
# Generate a report
deepfocus report "Weekly output: 12 tasks completed, 3 carried over"
# Log a weekly review
deepfocus weekly-review "Best week this month — cleared the entire backlog"
# View all statistics
deepfocus stats
# Export everything as JSON
deepfocus export json
# Search for entries mentioning "focus"
deepfocus search focus
# Check recent activity
deepfocus recent
# Health check
deepfocus statusPowered by BytesAgain | bytesagain.com | hello@bytesagain.com