Commands from nested folders are not getting read

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

when i create a command in a nested .cursor folder these are not getting read by cursor IDE thus are not showing up in the chat window or cursor settings, whereas when i create rules these show up in both chat context area and even in the cursor settings

Steps to Reproduce

  1. create a command in a nested folder in .cursor e.g. you are in root which is “TODO_APP” then in nested folder say “TODO_APP/acceptance_tests/.cursor/commands” you create a new command “create-bdd.md” this will not show up in cursor settings rules and commands section and won’t show up in chat window too

Expected Behavior

nested commands should show up in chat window

Operating System

MacOS

Current Cursor Version (Menu → About Cursor → Copy)

Version: 2.2.36
VSCode Version: 1.105.1
Commit: 55c9bc11e99cedd1fb93fbb7996abf779c583150
Date: 2025-12-18T06:25:21.733Z
Electron: 37.7.0
Chromium: 138.0.7204.251
Node.js: 22.20.0
V8: 13.8.258.32-electron.0
OS: Darwin arm64 25.1.0

Does this stop you from using Cursor

No - Cursor works, but with this issue

Hey, thanks for the report. This is not a bug but a functionality limitation. Commands are currently supported only in three places:

  1. .cursor/commands at the project root
  2. ~/.cursor/commands in the home directory
  3. Team commands in the dashboard (for teams)

Nested .cursor/commands folders in subdirectories are not supported.

Workaround: Place all commands in the root .cursor/commands folder and use descriptive filenames to separate by project, for example:

  • acceptance-tests-create-bdd.md
  • project-name-command.md

A similar question was discussed here: Can I have few '.commands' folders in one repo?

but the problem is some devs open in root some just open at acceptance-tests folder
so if i move the rules to root level then the devs that are opening acceptance tests won’t be able to see the commands

if we can have rules being read from nested folders what is preventing us from reading commands from nested folder?

feels like its a classic its not a bug its a feature…… just kidding :joy:

also i noticed these nested commands are eaisly getting read when i open my project as a workspace but i cannot use worktrees in workspace

i know that is an inherent limitation with vscode workspaces → but workspaces from single git repo should be able to support worktrees → i will start a different thread on this though

back to main point so nested commands are working in workspaces i think because workspaces make all nested projects move to root level → i am guessing it correct me if i am wrong please

This topic was automatically closed 22 days after the last reply. New replies are no longer allowed.