🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub✦ BytesAgain

Deepfocus

by @bytesagain-lab

Run Pomodoro sessions with break timers and productivity tracking. Use when starting focus sessions, tracking streaks, reviewing productivity.

Versionv2.0.0
Downloads389
Installs1
TERMINAL
clawhub install deepfocus

πŸ“– About This Skill


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 [args]

| Command | Description | |---------|-------------| | add | Add a new entry (task, note, idea). Without args, shows recent entries. | | plan | Create or view plan entries for organizing your day/week. | | track | Track progress on goals, habits, or tasks. | | review | Log review notes β€” reflect on what went well or needs improvement. | | streak | Record streak data for habit tracking and consistency. | | remind | Set reminders and notes for future reference. | | prioritize | Mark and log priority levels for tasks. | | archive | Archive completed or outdated entries. | | tag | Tag entries with labels for easy categorization. | | timeline | Add timeline entries for chronological tracking. | | report | Generate or log report entries for summaries. | | weekly-review | Log weekly review notes for end-of-week reflection. | | stats | Show summary statistics across all entry types. | | export | Export all data in json, csv, or txt format. | | search | 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|value format
  • A unified history.log records 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 status


    Powered by BytesAgain | bytesagain.com | hello@bytesagain.com

    ⚑ When to Use

    TriggerAction
    - 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 status


    Powered by BytesAgain | bytesagain.com | hello@bytesagain.com