omf

Install one or more packages

$ omf install [name]

$ omf list

$ omf theme

$ omf theme [name]

$ omf remove [name]

$ omf destroy

The omf command is the primary interface for managing your Oh My Fish installation, including its themes and plugins.

Syntax:
omf [arguments...]

Examples:
omf install bobthefish (installs a theme)
omf update (updates OMF and all components)
omf list plugins (lists installed plugins)

install
    Installs a plugin, theme, or a full Oh My Fish setup from a Git repository URL, or by name from the OMF registry.
Example: omf install git@github.com/my/plugin.git or omf install bobthefish.

update [plugin|theme]
    Updates Oh My Fish itself, all installed plugins, or specific plugins/themes.
Example: omf update or omf update bobthefish.

remove
    Removes an installed plugin or theme.
Example: omf remove agnoster.

list [plugins|themes]
    Lists all currently installed plugins or themes.
Example: omf list plugins.

channel
    Switches the update channel for Oh My Fish (e.g., stable, next).
Example: omf channel next.

theme
    A subcommand for managing themes. Common subcommands include install, use (to set the active theme), and list.

plugin
    A subcommand for managing plugins. Common subcommands include install, enable, disable, and list.

doctor
    Runs diagnostic checks to identify and suggest fixes for common Oh My Fish issues.

help [command]
    Displays general help or detailed help for a specific omf subcommand.

Oh My Fish (OMF) is a powerful and extensible framework for the Fish shell. It simplifies the process of managing themes, plugins, and custom functions, significantly enhancing the Fish shell experience. OMF allows users to easily install, update, and remove community-contributed themes and plugins, which can extend the shell's functionality, change its appearance, or automate common tasks. It provides a structured way to organize and load configurations, making the Fish shell more modular and user-friendly, especially for those who want to customize their command-line environment without writing complex shell scripts from scratch. OMF aims to bring a similar level of ease-of-use and extensibility to Fish as Oh My Zsh does for Zsh. It handles dependency management and updates for its installed components, ensuring a smooth and powerful interactive shell environment.

Oh My Fish is not a core Linux utility; it is a framework specifically designed for the Fish shell. Therefore, it requires the Fish shell to be installed and used as the default shell or specifically invoked.

Its functionality relies on Git for cloning repositories and managing plugins and themes. Configurations and installed components are specific to the Fish shell environment and do not affect other shells like Bash or Zsh.

Oh My Fish is typically installed by running a single command from its official website, which fetches and executes a script to set up the framework in the user's home directory. This process automatically sets up the omf command, making it available in your Fish shell sessions.

OMF provides a vast repository of community-contributed themes to customize the shell's appearance and plugins to extend its functionality. These can range from advanced Git prompts and syntax highlighting to utility functions for various development tasks. Users can easily discover and install these components using the omf install command, enhancing their command-line workflow with minimal effort.

Oh My Fish was created to provide a robust and easy-to-use plugin and theme management system for the Fish shell, mirroring the success and community around Oh My Zsh for Zsh. It began as an independent project to fill this gap in the Fish ecosystem, allowing users to extend their shell's capabilities without requiring deep scripting knowledge. Its development is community-driven, with contributions from many users adding new plugins and themes, and continuously improving the core framework. It gained popularity as the Fish shell itself grew in adoption, offering a user-friendly and powerful interactive shell experience.

fish(1), git(1)