Skip to content

thekaushikls/mo

Repository files navigation

Mo - tools to get the job done

mo

A work journal that takes seconds, not minutes.

Setup

mo init --path <vault-dir>    # creates mo.toml + vault directory
mo --version                  # check version

Day Lifecycle

mo login                      # start work day
mo login --mood tired         # start with a mood entry
mo logout                     # end work day
mo break                      # log a break
mo break "lunch"              # log a break with reason
mo mood "focused"             # update mood mid-day

Logging

mo work "fixed auth bug"                  # basic entry
mo work "standup" --meeting               # meeting
mo work "deploy v2" --done                # completed task
mo work "urgent prod fix" --urgent --now  # multiple tags
mo home "groceries" --todo                # house chores
mo play "guitar practice" --done          # fun / hobby
mo talk "cli feels slow on startup"       # feedback/bug report

Tags

--blocked --done --feature --meeting --note --now --research --todo --unplanned --urgent

Tags are supported on work, home, and play commands.

Viewing Logs

mo today             # formatted view of today's entries
mo log               # last 5 entries (raw)
mo log 20            # last 20 entries (raw)
mo log today         # today's entries (raw)
mo log month         # current month's entries (raw)
mo log file          # print current log file path

Entity Management

mo project ls                              # list projects
mo project add "name" --alias "shortname"  # add project
mo people ls                               # list people
mo people add "name" --alias "nickname"    # add person

Shell Completions

mo completions bash > ~/.local/share/bash-completion/completions/mo
mo completions zsh > ~/.zfunc/_mo
mo completions fish > ~/.config/fish/completions/mo.fish

Architecture

  • Append-only .log files, one per ISO week (logs/2026-W17.log)
  • Pipe-delimited format, one record per line
  • Vault config stored in mo.toml (projects, people with aliases)
  • Config supports local (./mo.toml) and global (~/.config/mo/mo.toml) paths

Builds

Pre-built binaries for Linux, macOS (Apple Silicon), and Windows (x86_64).

About

A work journal that takes seconds, not minutes

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Contributors

Languages