flk hook

Generate shell hooks that enable the refresh and switch commands for hot-reloading your development environment.

flk hook bash
flk hook zsh
flk hook fish

Usage

Add the hook output to your shell profile to enable refresh and switch:

# Bash (~/.bashrc)
eval "$(flk hook bash)"

# Zsh (~/.zshrc)
eval "$(flk hook zsh)"

# Fish (~/.config/fish/config.fish)
flk hook fish | source

Supported Shells

Commands Provided by the Hook

Once sourced, two shell functions become available:

Reload the current development environment. Picks up changes you’ve made (added packages, env vars, commands) without leaving the shell.

# After adding a package
flk add ripgrep
refresh

If direnv is present and .envrc exists, runs direnv reload
Otherwise, reuses a cached nix develop profile when it is still fresh
Rebuilds that cached profile when the flake inputs or relevant .flk files change
Uses FLK_FLAKE_REF (fallback: FLK_PROFILE) to determine the active profile

Switch to a different profile and reload the environment.

switch backend
switch frontend

Validates the profile name before switching
Updates FLK_FLAKE_REF and FLK_PROFILE, then reloads via direnv or nix develop
Reuses the saved profile cache until the environment definition changes

Notes

The hook integrates with direnv automatically — if .envrc is present, it uses direnv reload instead of exec nix develop
Profile names must be alphanumeric (with - or _)
See also: flk activate, flk direnv

Keyboard shortcuts