Unable to resolve your shell environment in a reasonable time. Please review your shell configuration and restart

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

Every time I launch Cursor 3 I get this error, and if I click the Configure icon it just takes me to the generic Settings interface with nothing that looks at all related to Shell/Terminal settings. Old reports of this involve going to a setting page that I cannot find in the non-IDE Cursor 3 interface. Please help :slight_smile:

Steps to Reproduce

Launching Cursor.

Expected Behavior

I dont see the error :slight_smile:

Screenshots / Screen Recordings

Operating System

MacOS

Version Information

Cursor 3.

Additional Information

Perhaps worth noting my default shell is fish.

Does this stop you from using Cursor

No - Cursor works, but with this issue

Hey, this is a known macOS thing with fish shell. When you launch Cursor from the Dock, it starts a shell in interactive plus login mode to load env vars, and fish, especially with plugins like tide or starship, often can’t finish within the default 10 seconds.

Two ways to fix it:

  1. Increase the timeout: open App Settings using Cmd+, in any Cursor window, don’t confuse it with IDE settings. Search for shellEnvironmentResolutionTimeout and set it to 30 or higher.
  2. Launch from Terminal: install the CLI via Cmd+Shift+P then run Install ‘cursor’ command, then start Cursor by running cursor in Terminal. In this case the env is already inherited and the resolve step won’t run.

The Configure button in Cursor 3 really doesn’t filter to the right setting. For now, manual search by the key above works.

thank you! the cursor terminal command works but im still missing something about how to find the aforementioned setting option. here’s a screenshot of where I end up.

In your screenshot, you’ve opened the wrong Settings window. Those are the glass/Agents window settings, so the option you need won’t be there.

Do this:

  • Cmd+Shift+P then Open Editor Window
  • In the editor window, press Cmd+,
  • Search for shellEnvironmentResolutionTimeout and increase it to 30 or higher

What am I missing? Even in these settings it doesnt show up for me..

Looks like Cmd+, is now remapped globally, so it opens the wrong Settings window. Here’s what to do:

  1. Open the Command Palette with Cmd+Shift+P and type Preferences: Open Settings (UI).
  2. In the search bar at the top of the Settings page, paste shellEnvironmentResolutionTimeout.
  3. Set it to 30 (or higher).

If the setting still doesn’t show up after step 2, let me know and send a screenshot of the Settings window with that search request entered.

yes that worked! and also taught me a lot about how to get around the cursor interface in general. thanks so much for your patience! <3