@habrmnc/bankai

Enter your flow state and track your sessions like a Soul Reaper.

@habrmnc/bankai is a premium, minimalist command-line productivity tool designed for developers who want to track their deep work, manage Pomodoro sessions, and monitor focus efficiency with global activity detection.

Developed by Habrmnc

Key Features

• Task & Project Tracking: Organize your deep work by specific tasks and project categories.
• Pomodoro Focus Mode: High-release focus sessions with live countdowns.
• Smart Idle Detection: Captures global mouse/keyboard activity and calculates your Focus Efficiency % in real-time.
• Detailed Reporting:
  • Daily, Weekly, and Monthly data views.
  • Custom Date Range filtering (--from and --to).
  • Professional ASCII table exports (--table).
• Premium Aesthetics: Dynamic gradients, ASCII art, and smooth animations powered by chalk and figlet.

Installation

Method 1: Global Install (Recommended)

You can install BANKAI directly from npm:

npm install -g @habrmnc/bankai

Method 2: Development Install

If you'd like to run it locally or contribute:

1. Clone & Install:

   git clone https://github.com/Habeeb-Rahman-CA/Bankai-CLI.git
   cd Bankai-CLI
   npm install

2. Link for CLI Use:

   npm link

[!IMPORTANT] This tool uses uiohook-napi for system-wide idle detection. If you are on Linux or macOS, you may need additional build tools or permissions for global input listeners.

Command Guide

1. bankai start

Begin tracking an active work session.

bankai start "Refactoring UI Components" --project "Dashboard-V2"

2. bankai focus

Activate Pomodoro mode with a live spinner.

# Focus for 50 minutes on a specific task
bankai focus 50 --task "Database Migration" --project "Backend"

3. bankai report

Unlock your productivity insights with advanced filters.

• Today: bankai report -d
• This Week: bankai report -w
• Last 30 Days: bankai report -m
• Table Summary: bankai report -t
• Custom Range: bankai report -f 2026-03-01 -e 2026-03-31

4. bankai tasks

List recent past tasks and their assigned IDs.

# List top 10 recent tasks
bankai tasks

# List all past tasks
bankai tasks --all

5. bankai update

Update the name, project, or duration of a past task.

bankai update 12 --task "New Task Name" --project "New Project" --duration 120

6. bankai delete

Delete a past task by its ID.

bankai delete 12

7. bankai recap

Review today's tracked time and interactively fill in untracked gaps (>15 mins).

bankai recap

Design Philosophy

Inspired by the "release" concept of Bankai, this CLI turns mundane task tracking into a visually engaging experience. It uses gradient-string for its iconic magenta-to-red aura and cli-table3 for precise, data-dense summaries.

License

MIT © Habrmnc

Created for deep work enthusiasts.