A PowerShell module to manage your command line tools, easily & consistently.
Install from the PowerShell Gallery — Install-PSResource -Name DotForge -Scope CurrentUser
Note
A tool that's already installed keeps its existing files where they are.
DotForge relocates many tools' config/data/cache to XDG-standard paths (e.g. RUSTUP_HOME/
CARGO_HOME for rustup, UV_TOOL_DIR for uv, PSReadLine's history file). When a tool
already has files at its old default location — an existing Rust toolchain, tools installed
with uv, prior command history — DotForge links the XDG folder to them instead, and never
moves or deletes them. Safety
lists every tool affected.
The goal of this tool is to make it easy to use commonly useful command line tools with a consistent and out-of-the-box useful configuration. For each tool it does its best to enforce XDG style standard directories (yes, on Windows) as I find this makes it easier to manage my configurations (with chezmoi). It also sets sensible, common default options, applies a standard color theme across all output, provides useful pickers with fzf as well as useful aliases. It also wires in shell integrations and hooks trying to ensure that they don't overwrite each other (fzf, zoxide, direnv, carapace, inshellisense, etc.). And it provides command line completions through carapace and inshellisense with occasional manual additions added through carapace's extension mechanism.
This is an experimental project developed out of my own PowerShell profile and generalized to hopefully be useful to others. It's also an experiment with AI development. I have a lifetime of development experience so it's not vibe coded slop. But it is currently the center of my learning experience with AI. I find it amazing at what the various AI tools (Claude, Codex, and Gemini are used here) are capable of. I also find it amazing at the things that they miss and get wrong, at bad design decisions, etc. The code is not yet fully reviewed, but I use this for my profile every day. Optimization is still a huge goal that we've not yet attained.
- Configures 47 command-line tools (bat, eza, fzf, ripgrep, zoxide, delta, starship, …) with XDG folders, sensible defaults and one shared color theme, from a JSON record per tool.
- Lets you pick one tool per job: prompt, pager, editor,
lsreplacement and more. Only the tool you choose (or the best installed one) hooks into the shell; see roles. - Adds fuzzy pickers and short commands: change folders, check out git branches, browse help, install packages, all through fzf.
- Sets up completion for hundreds of commands through Carapace, PSFzf and inshellisense, without them fighting over the Tab key.
- Installs tools with one command through scoop, winget or Chocolatey, and searches every package catalog at once with
trifle.
- PowerShell 7.2 or later
- Windows 11 (macOS and Linux are planned)
- scoop, winget or Chocolatey, to install tools
- fzf, for the pickers (optional but recommended)
Install the module:
Install-PSResource -Name DotForge -Scope CurrentUserThen add these lines to your profile (notepad $PROFILE), and open a new terminal:
Import-Module DotForge
Start-DFSession -Config @{ Tools = @('+core', '+prompt', '+git') }DotForge: Environment ready. Package managers: scoop, winget, choco
Import-Module DotForgeloads the module and its general commands (which,touch,mkcd,up, …).Start-DFSessionsets up the XDG folders and configures the installed tools you request. Tools you don't request are left alone.- If a requested tool is missing, the session warns you and points to
Install-DFTool -Missing; normal loads never install software.
Install a tool you don't have yet with Install-DFTool -Name ripgrep. To run the latest code from GitHub instead of the Gallery, clone the repository and Import-Module <clone>\DotForge.psd1.
| Page | Read it to |
|---|---|
| Getting started | install DotForge and set up your profile, step by step |
| Configuration | choose tools, change themes, pick between eza and lsd, and set every configuration key |
| Tools | see the 43 tools and the commands each adds |
| Fonts and icons | install a Nerd Font so tools can draw icons, and add font installers |
| Pickers and helpers | use the fuzzy pickers and general commands, and build your own picker |
| Completion | set up Tab completion with Carapace, PSFzf or inshellisense |
| Package catalog | search every package catalog at once with trifle (experimental) |
| Coreutils conflicts | fix commands that Coreutils for Windows intercepts |
| Troubleshooting | look up any warning or error |
| Safety | see everything DotForge reads, writes, runs and sends |
| Your own tools | add a tool DotForge doesn't ship, or change a shipped one, without forking |
| Writing a tool record | add or change a tool |
| Reference | look up any command, parameter or tool record |
| Examples | start from a complete profile |
Every command also has full help in the shell: Get-Help <command> -Full.
DotForge grew out of my own PowerShell profile. These are the projects around it:
- dotfiles-windows: My whole Windows setup, managed with chezmoi:
~/.config, the PowerShell profile, apps, keys and secrets. The other projects here are either used by it or published from it. - w11dwm-config: The keyboard-driven tiling desktop (komorebi, AutoHotkey, yasb, Flow Launcher, wpm), copied out of dotfiles-windows to share and discuss. Its key bindings, app launcher and window switcher are built on Legend.ahk.
- catelier: A Catppuccin theme for the yasb status bar, in all four flavors with your choice of accent. It's the bar in w11dwm-config and dotfiles-windows.
- zenppuccin: A Catppuccin theme for Zen Browser, in all four flavors with your choice of accent and optional translucency.
- Legend.ahk: An AutoHotkey v2 library: an Alt+/ overlay of the shortcuts for the app you're in, which-key style chord menus, pickers and a window switcher. It runs the keys in w11dwm-config and dotfiles-windows.
- starship-p9cat: A Starship prompt in the powerlevel9k style, in Catppuccin colors. It's the prompt in dotfiles-windows, and a port of the CatPow theme from poshcat.omp.
- poshcat.omp: Catppuccin themes for Oh My Posh, including CatPow, a powerlevel10k-style theme. It was my prompt before Starship; starship-p9cat carries CatPow over.
MIT — see LICENSE.
