Option for org-cycle-only-current-subtree-h to emulate Doom Emacs cycling behavior

Does this feature exist in Emacs orgmode core?

No

Orgmode link

Hi everyone,

Doom Emacs exposes an option org-cycle-only-current-subtree-h that disables the third stage in org cycling, where all heading contents are shown. With this option, TAB cycles only between folded → children visible → folded, without revealing the full subtree, which can make browsing notes faster for some workflows.

I understand this behavior differs from vanilla Org mode, but I thought it might be a useful optional feature in nvim-orgmode for users who prefer Doom Emacs–style cycling.

If this is not accepted, I plan to experiment with implementing it as a separate plugin.

Thanks for considering!

Feature value

• Faster navigation: Avoids accidentally expanding entire subtrees, letting users skim headlines and sub-headlines quickly.
• Reduced visual clutter: Large documents remain easier to read and focus on without unnecessary content expansion.
• Workflow customization: Provides a toggle for users who prefer limited expansion during navigation.
• Consistency in TAB behavior: Makes cycling predictable and less “jumpy” when moving through hierarchical notes.

Additional context

No response

Start by reading the linked Doom Emacs implementation in modules/lang/org/autoload/org.el around org-cycle-only-current-subtree-h, then locate the TAB/org cycling entry point in nvim-orgmode. Confirm how the current three-stage cycle behaves and define the option's folded → children visible → folded behavior; done means the optional setting prevents full-subtree expansion without changing default cycling.