lift. When no flags are given, Lift runs the pipeline tools specified in your config file (or all tools by default) in passive mode on the latest commit.
Processing modes
These flags control whether Lift processes a commit, not which tools run.
Passive mode is the default so you can run
lift as often as you like — in a hook, an alias, or muscle memory — without duplicating work.
Tool selection
When no tool flag is given, Lift runs the tools from thepipeline config setting (default: all four tools). When you pass one or more tool flags, only those tools run, overriding the config.
Tool flags combine freely:
Task number
The prefix defaults to
TAHO and can be overridden via the inky.task_prefix config setting.
Pull request
After all tools finish, Lift asks whether you’d like to open or update a PR. Stack mode enables this automatically.
Cleanup mode
Output control
Useful for scripting or CI environments where animated spinners aren’t wanted.
Common combinations
Configuration
Run
lift --config to see all available configuration options and the resolved merge result.
Preconditions
Lift validates two things before it runs:- Clean working directory — uncommitted changes cause Lift to exit with an error. Commit or stash your work first.
- Not on the main branch — Lift refuses to run on the configured main branch (default:
main). Switch to a feature branch first.