flexi

A minimal CLI tool for tracking your flexi-time balance.

Quickstart

cargo install flexi
flexi set 3 hr # set your bank
flexi add 1 hr 30 min # add to your bank
flexi remove 1 hr # subtract from your bank
flexi log # show change history
flexi # show current balance (3 hr 30 min)

Installation

Homebrew (macOS/Linux):

brew tap thombruce/tap
brew install thombruce/tap/flexi

crates.io (requires Rust):

cargo install flexi

From source:

cargo install --path .

Usage

flexi                      # display current balance
flexi add 1 hr 30 min     # add time
flexi add 1 hr --note "reason"  # add time with annotation
flexi remove 1 hr          # subtract time (alias: rm)
flexi set 2 hr             # set balance to exact value
flexi reset                # reset balance to zero
flexi reset --note "reason"  # reset with annotation
flexi log                  # show change history
flexi log --today          # today only (alias: --day)
flexi log --yesterday      # yesterday only
flexi log --week           # current calendar week
flexi log --month          # current calendar month
flexi log --since 2026-05-01 --until 2026-05-24  # date range
flexi log --last 10        # last 10 entries (combinable with filters)
flexi log --week --summary # totals for current week (added, removed, net)
flexi edit                 # open log file in $EDITOR
flexi undo                 # undo last change
flexi copy                 # copy balance to clipboard (alias: cp)
flexi completions <shell>  # print shell completion script

add and remove print the change and new balance (e.g. +1 hr 30 min → 3 hr). set and reset print the new balance. log prints one entry per line: 2026-05-24 10:20 +1 hr 30 min → 3 hr. Notes appear dimmed at the end: 2026-05-24 10:20 +1 hr 30 min → 3 hr # reason.

--note/-m works on add, remove, set, and reset. Place it before or after the time args.

Quotes are optional — flexi add 1h30m and flexi add "1h30m" are equivalent.

All of the following time formats are accepted:

Positive balances display in green, negative in red. Negative balances display as e.g. -1 hr 30 min.

Clipboard

flexi copy (or flexi cp) copies the current balance to the clipboard and prints it.

On Wayland, this requires the wl-clipboard package:

# Arch/Manjaro
pacman -S wl-clipboard
# Debian/Ubuntu
apt install wl-clipboard
# Fedora
dnf install wl-clipboard

On macOS and X11 Linux, no extra dependencies are needed.

Shell completions

flexi completions zsh > ~/.zsh/completions/_flexi
flexi completions bash > ~/.bash_completion.d/flexi
flexi completions fish > ~/.config/fish/completions/flexi.fish

Configuration

Create ~/.config/flexi/flexi.toml to configure flexi:

path = "/path/to/flexi.txt"
timestamp_format = "simple"  # "simple" (default) or "full"
week_start = "monday"        # "monday" (default) or "sunday"

Without config, data is stored at ~/.local/share/flexi/flexi.txt (or the platform equivalent). This file is the change log — the current balance is derived from the last entry.

License

MIT