Skip to content

Latest commit

 

History

History

README.md

Fish Configuration

Fish shell configuration for interactive work, dotfiles maintenance, and local workflow commands.

Layout

  • config.fish is the entrypoint.
  • aliases.fish, profile.fish, scripts.fish, coreutils.fish, gum.fish, and colors.fish are sourced from the entrypoint.
  • functions/ contains autoloaded Fish functions.
  • libexec/ contains TypeScript/Bun helpers used by wrapper functions.

Function Groups

  • Agent workflows: ai_commit.fish and codex-reset.fish.
  • OpenCode fallback: opencode.fish.
  • Azure DevOps helpers: ado_test_case.fish, workitems_on_date.fish, workitems_week.fish, workitems_cache_clear.fish.
  • Herdr: herdr_link_plugins.fish links the tracked local Herdr plugins after stow ..
  • Worktree and branch helpers: wt.fish, worktree_add.fish, worktree_clone.fish, latest_worktree.fish, wtfzf.fish.
  • Nix helpers: flake_update_interactive.fish, flake_updates_daemon.fish, flake_restore.fish, nxrb.fish.
  • Navigation and utilities: cdlc.fish, cdlm.fish, fzfcd.fish, mntnas.fish, open.fish, killport.fish, gamescope_kill.fish, disk_space.fish.
  • Time and workday helpers: first_login_of_the_day.fish, set_workday_start.fish, remaining_work_hours.fish, workday_end.fish, date parsing helpers.

Helper Scripts

Fish wrappers call Bun helpers from libexec/ with bun --cwd .... Keep helper dependencies in libexec/package.json and libexec/bun.lock.

Biome config for helper scripts lives at libexec/biome.json.

Notes

  • Functions are autoloaded by Fish; avoid sourcing function files manually from config.fish unless startup order requires it.
  • Some commands assume local tools such as gum, fzf, fd, bun, opencode, and wt are available from the system environment.
  • Package installation belongs in the Nix system repo, not this dotfiles repo.