Sneaky Docs is a lightweight extension that adds right-click context menu options to collapse or uncollapse all Python docstrings and JavaScript/TypeScript JSDoc blocks in the editor.
Features
Adds multiple context menu entries in the editor:
Collapse All Docstrings / JSDoc
Uncollapse All Docstrings / JSDoc
Export Selected Function
Generate JSDoc for Function
Automatically detects and folds:
Python docstrings using triple quotes (''' or """)
JSDoc comments using /** ... */ in JavaScript and TypeScript files
Helps improve code readability by hiding large documentation blocks
Automatically adds missing module.exports entries for functions in .js / .ts files, based on file content
Generates structured JSDoc comments (/** ... */) above a selected or surrounding function, including:
Parameter names and types
Default values
Destructured options objects
@returns and example usage
Uses smart formatting and preserves indentation/style of surrounding code
Supported Languages
Python (.py)
JavaScript (.js)
TypeScript (.ts)
How to Use
Open any .py, .js, or .ts file in the editor.
Right-click anywhere in the editor.
Choose one of the following options:
Collapse All Docstrings / JSDoc
Uncollapse All Docstrings / JSDoc
Export Selected Function – scans the file and inserts missing entries into module.exports, keeping correct order and formatting
Generate JSDoc for Function – analyzes the current function (based on cursor position) and inserts a JSDoc block above it
Alternatively, use the command palette (Ctrl+Shift+P) and run:
Collapse All Docstrings / JSDoc
Uncollapse All Docstrings / JSDoc
CollapseDocs: Export Selected Function
CollapseDocs: Generate JSDoc for Function
Recommended Settings
To improve the visual appearance of folded regions (e.g., make them better match dark themes), consider adding this to your settings.json:
