omm (stands for “on-my-mind”) is a keyboard-driven task manager for the command line.

🤔 Motivation

The fundamental idea behind omm is that while we might have several tasks on our to-do list — each with its own priority — we typically focus on one task at a time. Priorities frequently change, requiring us to switch between tasks. omm lets you visualize this shifting priority order with a very simple list interface that can be managed entirely via the keyboard.

💾 Installation

homebrew:

brew install dhth/tap/omm

go:

go install github.com/dhth/omm@latest

Or get the binaries directly from a release.

💡 Guide

omm offers a guided walkthrough of its features, intended for new users of it. Run it as follows.

omm guide

📋 Updates

Check out the latest features added to omm using:

omm updates

⚡️ Usage

omm -h

Usage:
  omm [flags]
  omm [command]

Available Commands:
  guide       Starts a guided walkthrough of omm's features
  help        Help about any command
  import      Import tasks into omm from stdin
  tasks       Output tasks tracked by omm to stdout
  updates     List updates recently added to omm

Flags:
      --circular-nav              whether to enable circular navigation for lists (cycle back to the first entry from the last, and vice versa)
  -c, --config-path string        location of omm's TOML config file (default "~/.config/omm/omm.toml")
      --confirm-before-deletion   whether to ask for confirmation before deleting a task (default true)
  -d, --db-path string            location of omm's database file (default "~/.local/share/omm/omm.db")
      --editor string             editor command to run when adding/editing context to a task (default "vi")
  -h, --help                      help for omm
      --list-density string       type of density for the list; possible values: [compact, spacious] (default "compact")
      --show-context              whether to start omm with a visible task context pane or not; this can later be toggled on/off in the TUI
  -t, --theme string              theme to use; possible values: [catppuccin-mocha, dracula, github-dark, gruvbox-dark, monokai-classic, onedark, rose-pine-moon, tokyonight, xcode-dark] (default "gruvbox-dark")
      --title string              title of the task list, will trim till 8 chars (default "omm")
  -v, --version                   version for omm

TUI

omm’s TUI is comprised of several views: 4 lists (for active and archived tasks, one for task bookmarks, and one for prefix selection), a context pane, a task details pane, and a task entry/update pane.

Active Tasks List

As the name suggests, the active tasks list is for the tasks you’re actively working on right now. It allows you to do the following:

• Create/update tasks at a specific position in the priority list
• Add a task at the start/end of the list
• Move a task to the top of the list (indicating that it takes the highest priority at the moment)
• Move task up/down based on changing priorities
• Archive a task
• Permanently delete a task

Archived Tasks List

Once you’re done with a task, you can archive it, which puts it in the archived tasks list. It’s more for historical reference, but you can also unarchive a task and put it back in the active list, if you need to. You can also permanently delete tasks from here.

Context Pane

For tasks that need more details that you can fit in a one line summary, there is the context pane. You add/update context for a task via a text editor which is chosen based on the following look ups:

• the “–editor” flag
• $OMM_EDITOR
• “editor” property in omm’s toml config
• $EDITOR/$VISUAL
• vi (fallback)

Task Details Pane

The Task Details pane lets you see all details for a task in a single scrollable pane.

Task Entry Pane

This is where you enter/update a task summary. If you enter a summary in the format prefix: task summary goes here, omm will highlight the prefix for you in the task lists.

Tweaking the TUI

Themes

omm comes with the following themes built in:

• catppuccin-mocha
• dracula
• github-dark
• gruvbox-dark
• monokai-classic
• onedark
• rose-pine-moon
• tokyonight
• xcode-dark

You can have omm start with any one of these via its config (described below). The active theme can also be changed in the TUI using the keymaps [ and ].

Visual density

omm offers two modes for the visual density of its lists: “compact” and “spacious”, the former being the default. omm can be started with one of the two modes, which can later be switched by pressing “v”.

omm --list-density=spacious

This configuration property can also be provided via the environment variable OMM_LIST_DENSITY.

Compact mode:

Spacious mode:

Importing tasks

Multiple tasks can be imported from stdin using the import subcommand.

cat << 'EOF' | omm import
orders: order new ACME rocket skates
traps: draw fake tunnel on the canyon wall
tech: assemble ACME jet-propelled pogo stick
EOF

Tip: Vim users can import tasks into omm by making a visual selection and running :'<,'>!omm import<CR>.

Adding a single task

When an argument is passed to omm, it saves it as a task, instead of opening up the TUI.

omm "Install spring-loaded boxing glove"

Configuration

omm allows you to change the some of its behavior via configuration, which it will consider in the order listed below:

• CLI flags (run omm -h to see details)

• Environment variables (eg. OMM_EDITOR)

• A TOML configuration file (run omm -h to see where this lives; you can change this via the flag --config-path)

  Here’s a sample config file:

  db_path                 = "~/.local/share/omm/omm-w.db"
  theme                   = "tokyonight"
  title                   = "work"
  list_density            = "spacious"
  show_context            = false
  editor                  = "vi -u NONE"
  confirm_before_deletion = false
  circular_nav            = true
  

Outputting tasks

Tasks can be outputted to stdout using the tasks subcommand.

omm tasks

🤔 Tips

These are some tips to improve your experience of using omm:

• Set up discrete instances of omm if you need to. You can do so by referencing a different config file (which points to a unique database) for each instance, or by directly using --db-path flag. Eg. an omm instance for personal tasks, and another for work. Set up as many omm instances as you need!
• Use omm updates to stay up to date with omm’s latest features/changes.

⌨️ Keymaps

General

Active/Archived Tasks List

Active Tasks List

Task Creation/Update Pane

Task Details Pane

Task Bookmarks List

Acknowledgements

omm stands on the shoulders of giants.

• bubbletea as the TUI framework
• sqlite as the local database
• goreleaser for releasing binaries

Changelog

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

v0.7.0 - Mar 06, 2026

Added

• Allow changing theme at runtime via the TUI
• Configure theme via –theme/OMM_THEME/config-file
• Allow duplicating tasks

Removed

• Support for providing colors via the flags --tl-color and --atl-color

v0.6.0 - May 02, 2025

Changes

• Use full width for context and task details
• Increase upper threshold for context length to 1 MB (was 4KB before)
• Preserve newlines in rendered context

v0.5.1 - Aug 13, 2024

Fixed

• Fixed issue where omm would panic when tasks summaries of certain lengths were entered (on certain platforms)

v0.5.0 - Aug 03, 2024

Added

• URIs with custom schemes are considered as task bookmarks. eg.
  • spotify:track:4fVBFyglBhMf0erfF7pBJp
  • obsidian://open?vault=VAULT&file=FILE
• Circular navigation for lists

v0.4.3 - Jul 28, 2024

Added

• Flag for changing deletion behavior

Changes

• omm asks for confirmation before deleting a task by default

v0.4.2 - Jul 26, 2024

Fixed

• Fixed issue where pager didn’t respond to arrow keys

v0.4.0 - Jul 26, 2024

Added

• Markdown in task context is rendered with syntax highlighting
• Task Lists in “compact” mode highlight prefixes
• Tasks Lists can be filtered
• Quick filters based on task prefixes can be applied
• Prefix can be chosen during task creation/update
• Keymap to move an active task to the end of the list
• “updates” subcommand

Changes

• Task Lists in “compact” mode show more than 9 tasks at a time, when maximised

Removed

• Keymaps ([2-9]) for the Active Tasks list to move task at a specific index to the top

v0.3.1 - Jul 19, 2024

Changes

• URLs in a task’s summary are also considered as bookmarks

v0.3.0 - Jul 19, 2024

Added

• The ability to quickly open URLs present in a task’s context
• Support for providing configuration via a TOML file
• The ability to copy a task’s context

v0.2.2 - Jul 15, 2024

Fixed

• Fixed issue where closing the “Task Details” pane would move the active task list to the next page

v0.2.1 - Jul 15, 2024

Fixed

• Fixed issue where omm’s database would be stored in an incorrect location on Windows

v0.2.0 - Jul 14, 2024

Added

• Added “task context”, which can be used for additional details for a task that don’t fit in the summary
• A new list density mode
• “Task Details” pane
• An onboarding guide

Changed

• Task lists now highlight prefixes in task summaries, when provided

v0.1.0 - Jul 09, 2024

Added

• Initial release