Skip to main content

Fish Plugin

The Fish plugin provides in-prompt text expansion using Fish's commandline builtin.

Installation​

Add to your ~/.config/fish/config.fish:

source /path/to/shell/cli-expander.fish

Usage​

Type a trigger and press Space — the plugin automatically expands:

> echo :hello[space]
> echo Hello World!

You can also press Ctrl+T for manual expansion.

How It Works​

The plugin binds to the Space key. When Space is pressed, it checks if the current command line contains a trigger pattern and expands it.

FZF trigger search (Ctrl+F/Alt+F) is not yet available for Fish. This feature is planned and tracked in Phase 15. The Bash plugin currently has the only shell-native fzf integration.

For now, Fish users can use:

  • Ctrl+T for manual trigger expansion
  • The Tmux popup picker (prefix+Ctrl+g) if using tmux
  • ce list and ce search <query> directly from the command line

Changing the Keybinding​

Edit shell/cli-expander.fish and change the bind line:

# Change to Ctrl+E instead of Ctrl+T
bind \ce _cli_expander_expand

What's Next​

Explore Advanced Usage with variable chaining and system-wide mode.