Your file tree
is your command tree.

Absent

Zero config. The git root is the project and default discovery supplies the command tree. Most projects can stay here.

$ cd ~/code/acme/infra/cloud
$ mnmd root
/home/you/code/acme

Declarative

Any file without a shebang, including an empty one. monom parses it and never runs it: declare paths the gate skips, hide entries, set mnmd check's severity.

# register an executable the gate would skip
tools/Format.sh
# make mnmd check fail on unregistered executables
check.root-contents = error
# hide more entries, like dot-files (repeatable)
discover.hide = infra/local

Hook script

An executable with a shebang. monom runs it for hooks, all optional: complete, run, config, debug. Leave one out and the default applies.

#!/usr/bin/env bash
# every hook is optional: without complete,
# default discovery lists the commands
case "$1" in
  run)
    shift
    # monom ship → infra cloud deploy
    if [ "$1" = ship ]; then echo infra cloud deploy; fi
    ;;
  config)
    echo "discover.hide = tools"
    ;;
esac

Any language, even compiled

monom resolves a path and execs it. Your script never imports, sources, or links anything; a shebang or a binary is all it needs.

• db migrate#!/usr/bin/env python3
• db seed#!/usr/bin/env node
• infra cloud deploy#!/usr/bin/env bash
• infra local start#!/usr/bin/env bash
• tools lintcompiled Go binary
• release#!/usr/bin/env ruby

Go owns logic, shell owns surface

Discovery, filtering and resolution live in mnmd, a compiled Go binary. The shell layer is only what Go can't do: define monom, register completion, exec.

$ type -t monom mnmd
function
function

Tab tested with real key presses

Completion is covered by YAML cases that start interactive bash and zsh in a pseudo-terminal, press Tab, and check the edit line and the listing on screen.

- name: tab completes a unique prefix and adds a space
  input: monom in
  action: keys
  tabs: 1
  line: "monom infra "

Completion never breaks mid-typing

mnmd filter always exits 0. A broken path yields no suggestion, not an error splashed over your prompt. Diagnostics live in mnmd check.

$ echo 'bad path/x' | mnmd filter bad
$ echo $?
0

Your code can own the list

A complete hook that prints paths replaces default discovery entirely: read git ls-files, parse a manifest, anything that prints lines.

  complete)
    cd "$(dirname "$0")" || exit
    # tracked executables, minus this file
    git ls-files -s | awk '$1 == 100755 { print $4 }' | grep -vx monom
    ;;

No lock-in

Your commands are plain executables in plain folders. Delete monom tomorrow and ./infra/cloud/deploy.sh still runs.

$ ./infra/cloud/deploy.sh
deploying to cloud...