Software⏱️ 3 min read📅 2026-06-11

How to Fix: Why am I having / how can I fix this error: "shell_session_update: command not found"

Error message in RVM with fish shell integration on OS X El Capitan.

Quick Answer: Check if the rvm.fish file has been modified or corrupted, and try reinstalling RVM or updating the fish shell integration.

The error 'shell_session_update: command not found' occurs when you're trying to use RVM (Ruby Version Manager) with the fish shell on a MacBook running OS X El Capitan. This issue affects users who have integrated RVM with their fish shell environment.

This error can be frustrating, especially if you're in the middle of a development project. However, don't worry, we've got you covered. By following these steps, you should be able to resolve this issue and get back to coding.

🔍 Why This Happens

  • The primary reason for this error is that RVM uses a fish-specific function called `shell_session_update` which isn't available in the standard fish shell environment. This function is necessary for RVM to maintain its session settings between commands.
  • An alternative cause could be that there's an issue with your RVM installation or configuration, but this is less likely given that you've successfully installed and used a different Ruby version (2.0.0) in the same terminal session.

✅ Best Solutions to Fix It

Updating fish shell configuration

  1. Step 1: Open the `~/.config/fish/config.fish` file in your favorite text editor.
  2. Step 2: Add the following line at the end of the file: `function shell_session_update -i 'rvm use %x'`. This sets up the fish-specific function for RVM to update the session settings when you switch between Ruby versions.
  3. Step 3: Save and close the file. Then, restart your terminal or run `source ~/.config/fish/config.fish` to apply the changes.

Updating RVM configuration

  1. Step 1: Run the following command in your terminal: `rvm config update`. This updates RVM's configuration files, including the fish shell integration.
  2. Step 2: Check if the issue is resolved by running a command like `rvm version` or `rvm install ` and see if you get the 'shell_session_update: command not found' error.

🎯 Final Words

By following these steps, you should be able to resolve the 'shell_session_update: command not found' error in RVM on your MacBook using the fish shell. If you're still experiencing issues, feel free to ask for further assistance.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions