iforgor

The CLI tool for all those commands you forget about.

Installation

cargo install iforgor

Quick start

1. Create a .iforgor/ folder in your project (or ~/.iforgor/ for global commands).
2. Add a TOML file with your commands:

[source]
name = "My commands"

[[entries]]
name = "Hello world"
script = 'echo "Hello, world!"'

[[entries]]
name = "Deploy"
description = "Deploy to production"
tags = ["deploy"]
risky = true
script = '''
echo "Deploying $ENV..."
'''

[[entries.args]]
name = "ENV"
prompt = "Select environment"
type = "select"
choices = ["staging", "prod"]

3. Run iforgor in that directory.

How it works

iforgor auto-discovers .iforgor/ folders by walking from your current directory upward to the filesystem root, plus ~/.iforgor/ for global commands. Each .toml file inside these folders is a domain containing one or more command entries.

Example layout:

~/.iforgor/              # Global commands
  rust.toml
  git.toml
~/project/.iforgor/      # Project-specific
  dev.toml
  ci/deploy.toml         # Subfolders become domain prefixes

TUI keyboard shortcuts

When the search is empty, the list shows your command history (most recent first). Type a space to show the full command list.

Command format

Each TOML file has an optional [source] header and one or more [[entries]]:

[source]
name = "Domain name"
description = "Optional description"

[[entries]]
name = "Command name"
script = '''
echo "hello"
'''

Optional fields

Shell

Predefined shells: "sh", "bash", "zsh", "fish", "cmd", "powershell".

Custom shell:

shell = { command = "nushell", extension = ".nu", shebang = "#!/usr/bin/env nu" }

Arguments

Arguments are collected before script execution and injected as environment variables:

[[entries.args]]
name = "BRANCH"                  # Variable name in the script ($BRANCH)
prompt = "Select branch"         # Displayed to user (defaults to name)
type = "select"                  # "text" (default), "select", or "multi-select"
choices = ["main", "dev"]        # Static choices for select/multi-select
source = "git branch"            # Or dynamic choices from a shell command's stdout
default = "main"                 # Default for text args
post_transform = "tr '\\n' ' '" # Pipe selected value through a shell command
secret = false                   # Mask input (for passwords/tokens)
remember = true                  # Remember last value across runs (default: true)

For select and multi-select, provide either choices (static list) or source (shell command whose stdout lines become choices).

Config

Create .iforgor/.config.toml to set defaults. The closest config file wins (project overrides global):

default_shell = "bash"
default_after_run = "wait"

CLI subcommands