Deepfocus

---
version: "1.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|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

```bash
# 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