ZevFocus CLI Documentation

📦 Installation

Windows:

irm https://zevfocus.github.io/ZevFocus/install.ps1 | iex

Linux (x86_64):

curl -sSL https://zevfocus.github.io/ZevFocus/install.sh | bash

Mac:

curl -sSL https://zevfocus.github.io/ZevFocus/install_mac.sh | bash

This installs zevfocus globally in your system.

🚀 Quick‑Start


$ zevfocus login YourName
$ zevfocus application
$ zevfocus whitelist --application <>
$ zevfocus whitelist --list
$ zevfocus start --taskname "Write blog post"
...stay focused...
$ zevfocus stop
$ zevfocus summary
$ zevfocus share
$ zevfocus logout
$ zevfocus version

🔐 Login

zevfocus login YourName

🕵️ Application Tracking

Detect the currently active application:

zevfocus application

📋 Manage Whitelist

Whitelist apps to count only focused work:

zevfocus whitelist --application "code,sublime"

zevfocus whitelist --list

🎯 Start a Focus Session

zevfocus start --taskname "Design new UI"

🛑 Stop Session

zevfocus stop

🎯 Session Ended.
🕒 Focus Duration: 110 minutes
🔥 Streak: 3 days

📊 Summary

zevfocus summary

🧠 Total Focus Time: 5h 45m
📆 Sessions: 4
🔥 Streak: 4 days
🎯 Top Task: "Debug analytics bug"

🐦 Share to Twitter

zevfocus share

🐦 ZevFocus Summary
User: YourName
🕒 110m deep work
🔥 Streak: 3 days
Hash: 9f1c2b8e

🔍 Verify a Hash

Click here to verify your tweet hash.

🔢 Version

zevfocus version

🚪 Logout

zevfocus logout

🧠 How It Works

Stores data locally at ~/.zevfocus/
Uses HMAC for secure hashes
Idle time is filtered automatically

🛠 Troubleshooting

“Command not found?” — Add to your $PATH
“Idle not detected?” — Ensure activity input
“Want to reset?” — Delete ~/.ZevFocus

❓ FAQ

Offline by default
Nothing is shared unless you run `share`
Fully scriptable in CI/shell

📣 Feedback

Submit feedback or bugs