shellfirm init

The init command sets up shell hooks so shellfirm can intercept commands before they execute.

Usage

shellfirm init [OPTIONS] [SHELL]

Options

Flag	Description	Default
--install	Install hooks for all detected shells	-
--uninstall	Remove hooks from all configured shells	-

Arguments

Argument	Description
SHELL	Target shell: zsh, bash, fish, nushell, powershell, elvish, xonsh, oils

Modes

Automatic setup

Install hooks for all detected shells:

shellfirm init --install

This scans your system for installed shells and appends the appropriate hook to each shell's configuration file. After running, restart your shell.

Automatic removal

Remove hooks from all shells:

shellfirm init --uninstall

Generate hook script

Print the hook script for a specific shell (useful for manual setup):

shellfirm init zsh

Output can be piped to your shell config:

shellfirm init zsh >> ~/.zshrc

Or used with eval:

eval "$(shellfirm init zsh)"

Examples

# Install for all detected shells
shellfirm init --install

# Generate Zsh hook script
shellfirm init zsh

# Generate Fish hook script
shellfirm init fish

# Remove all hooks
shellfirm init --uninstall

Shell-specific output

Each shell produces a different hook format:

Shell	Eval command
Zsh	eval "$(shellfirm init zsh)"
Bash	eval "$(shellfirm init bash)"
Fish	shellfirm init fish | source
Nushell	source (shellfirm init nushell | save --force ~/.shellfirm.nu; echo ~/.shellfirm.nu)
PowerShell	Invoke-Expression (shellfirm init powershell | Out-String)
Elvish	eval (shellfirm init elvish | slurp)
Xonsh	execx($(shellfirm init xonsh))
Oils	eval "$(shellfirm init oils)"