Stata All in One

One VS Code extension tailored for Stata users

| Version: 0.2.18 | Author: Zihao Viston Wang | Translate: 中文版本 |

All-in-one Stata experience:
Code Execution + Syntax Highlighting + Code Completion + Smart Outline + Data Viewing + AI Skill!

Ready out of the box!
Natively integrated into VS Code—no need to configure external environments like Python or Node.js.

Stata All in One is derived from Stata Outline, expanded with new features and improvements.

Sponsors

Special thanks to RedNote user Rich**d, WeChat user 早起**阳光, and Buy Me a Coffee user LB**PG@gmail.com for their generous donations and support for this project.

Features

Click to view full image

⚠️ Features marked with 🔑 require a STATA.LIC license file. Please support genuine software to enjoy the full experience.

1. AI Skill (Experimental) 🔑

• Let AI Agents Run Stata Code: Start a local HTTP server (default port 19521) inside VS Code, allowing AI coding tools (Claude Code, Cursor, Codex CLI, Open Code, OpenClaw, etc.) to execute Stata code and read results using only the built-in curl command.
• Zero External Dependencies: No need to install Python, Node.js, or any third-party tools — just VS Code and the system curl (or PowerShell).
• Leave the setup to AI: Click the AI button in the editor toolbar, copy the prompt, and paste it to your AI tool. The AI will configure itself automatically.
• Auto-Start: When enabled, the HTTP server starts automatically when VS Code opens. AI agents can run Stata code anytime.
• Toggle Control: Find the AI button in the editor toolbar (next to Run), or manage via Stata All in One > AI Skill Enabled in settings. When disabled, the server is not started.

2. Code Execution (Stata Interaction)

• Platform Support: Seamlessly integrates with Stata on both macOS and Windows without requiring additional extensions.
• Two Run Modes:
  • Embedded Console (default) 🔑: Run and display Stata output directly within VS Code! Including command results, error messages, command window output, and graph output — a true all-in-one IDE experience.
  • External App: Continue using the traditional approach of sending code to the Stata GUI, for users who prefer Stata's native interface. Windows now uses Stata COM Automation, delivering significantly better performance than the previous PowerShell-based implementation.
• Multi-Scenario Execution Strategies:
  • Section Execution: When the cursor is on a header line (e.g., ** # Title), click the ▶️ button or press Ctrl/Cmd + D to execute all code from that header to the next same-level or higher-level header (i.e., the entire section).
  • Single Line Execution: When the cursor is on a regular code line (no selection), click the ▶️ button or press Ctrl/Cmd + D to execute only that specific line.
  • Selected Code Execution: When multiple lines are selected, click the ▶️ button or press Ctrl/Cmd + D to execute the selected lines. Supports fuzzy selection — no need to precisely select the first or last line of a code segment; the system automatically captures and runs all lines covered by the selection.

3. Enhanced Syntax Highlighting & Code Completion

• Full Syntax Highlighting and Code Completion Support: Integrates Stata Enhanced syntax engine[^1], providing precise syntax highlighting and code completion for .do files (under MIT License).
• Custom Command Highlighting: Supports highlighting for commonly used third-party commands (e.g., reghdfe, ivreghdfe, gtools), freely configurable in settings.
• Dataset Variable Autocompletion: (After running code once) Provides intelligent autocomplete suggestions based on the current dataset when typing variable names in the editor and console, boosting coding efficiency.

[^1]: Stata Enhanced syntax engine was developed by Kyle Barron, providing comprehensive support for the Stata language. This extension follows the MIT License. Thanks to Kyle Barron for his contribution!

4. Smart Outline & Structural Navigation

• Multi-level Outline Recognition: Automatically detects comment lines from **# to **###### as hierarchical headers, supporting up to 6 levels.
  • Shortcuts: Ctrl/Cmd + 1-6 to quickly convert to the corresponding header level; Ctrl/Cmd + 0 to revert to a standard code line.
• Cursor Auto-Follow: The outline view automatically highlights and navigates to the corresponding section as the cursor moves in the editor.
  • Setup: Click the "···" button in the top-right of the Outline view and check "Follow Cursor".[^2]
• Multi-level Numbering: Optional display of logical numbering (e.g., 1.1, 1.2.1) within the outline (must be enabled in settings).
• Auto-Sync Numbering: When enabled, the extension automatically adds or removes numbering directly within the .do file based on the outline structure.
• program define Block Recognition: Displays program names in the outline view for easy navigation and management of custom programs.

[^2]: Sorry~ This is a VS Code GUI setting, I cannot control it through the extension.

5. Data Viewer 🔑

• Click to View: Click a .dta file in the VS Code Explorer to open it in the new Data Viewer panel.
  • Variable Info: Variable table displays metadata such as name, label, and type.
  • Data Browsing: Supports lazy loading of rows and columns — easily browse large datasets right in VS Code without opening Stata.
• View After Run: After running code, instantly view results in the Data Viewer within the Console panel. Works in both run modes — no need to switch back and forth.
• Data Filtering: Provides Stata-style filtering for quickly locating subsets of data.

6. Efficient Separator Lines & Styling

• Quick Insertion: Supports various symbols to significantly enhance code readability.
  • Standard Separators: Use Ctrl/Cmd + Symbol to quickly insert separator lines:
    • Ctrl/Cmd + - (Dash) | Ctrl/Cmd + = (Equal) | Ctrl/Cmd + Shift + 8 (Asterisk)
  • Custom Separators:
    • Ctrl + Alt + S (Windows) | Ctrl + Cmd + S (macOS), where S stands for "Separator".
    • After pressing the shortcut, simply input your desired character to generate the corresponding separator line.
• Intelligent Wrap Mode:
  • Blank Line Insertion: Generates a full-width separator line (length adjustable in settings).
  • Non-blank Line Insertion: Pressing the shortcut once inserts above the line; pressing it again inserts below, creating a "wrapped" effect.
  • Header Decoration: Select some characters of a header and press the shortcut to generate a title with balanced decorative symbols (e.g., **# === Title ===), without affecting outline recognition.
    • Centered Header: If using Header Decoration + Custom space separator, the header content will be automatically centered.

7. More Features

1. Enhanced Embedded Console 🔑

   • Graph Output

     • Direct Display: Render Stata graph output directly in the embedded console.
     • Export Options: Save graphs as SVG, PNG (configurable DPI), or copy to clipboard.
     • Fullscreen View: Click a graph to view it in fullscreen mode for detailed inspection.

   • Progress Display

     • Command Execution Status: For long-running commands like bootstrap, bdiff, and xthreg, the console shows real-time progress (e.g. 50/2000) and estimated time remaining. Other commands display elapsed time.

   • Custom Font:

     • Font Settings: Use stata-all-in-one.consoleFontMode and stata-all-in-one.consoleCustomFontFamily to customize the console font for a better reading experience.

2. Enhanced Comments

   • Toggle Comments: Quickly toggle line comments using Ctrl/Cmd + /.
   • Optional Styles: Defaults to //, with support for switching to other valid Stata comment delimiters in settings.

3. Built-in Help

   • Show Help Text: For example, select regress and press Ctrl/Cmd + Shift + H. In External App mode, this opens Stata's regress help page; in Embedded Console mode, the help text is displayed directly in the console.
   • Hover Help: Hover over a Stata command to see help information, with automatic filtering of non-practical commands like #delimit, using, etc.

4. Smart Line Break

   • One-Key Line Break: Use Shift+Enter to insert Stata line continuation symbol /// at the cursor position.
   • Smart Indentation: Automatically indent by 4 spaces

5. Safe Rename Mode

   • Rename Variable: Select a variable and press F2 to rename all occurrences in the current document.
   • Smart Validation: Automatically validates the new name to ensure it follows Stata naming rules and does not conflict with built-in commands or keywords.
   • Command Protection: Intelligently prevents renaming Stata commands (e.g., reghdfe, outreg2) and their options (e.g., absorb, ctitle).

6. Auto cd to Do File Directory

   • Auto Working Directory: When enabled, automatically sets Stata's working directory to the do file's location on first launch.

7. Quick Settings

   • Settings Button: Click the gear icon in the editor title bar to quickly access Stata All in One settings.

Keyboard Shortcuts

Click here to view the complete list of keyboard shortcuts.

Installation

Install from Extension Marketplace

• VS Code: Search for "Stata All in One" in extensions and install.

Download and Install (for Cursor, Trae and other VSCode-based IDEs)

1. Download stata-all-in-one-x.x.x.vsix from either source:
   • Open VSX Registry
   • GitHub Releases Page
2. Open Extensions panel in your editor → ... → Install from VSIX....
3. Select the downloaded .vsix file to complete installation.

Configuration

Search for "Stata All in One" in VS Code settings and configure:

AI Skill

1. AI Skill Enabled (stata-all-in-one.aiSkillEnabled)

   • true (default): Start a localhost HTTP server when VS Code opens, allowing AI coding tools to execute Stata code.
   • false: The extension only activates when .do/.dta files are opened, and no HTTP server is started.

2. AI Skill Port (stata-all-in-one.aiSkillPort)

   • Port number for the AI Skill HTTP server. Default 19521. Change if the port is in use.

Code Execution

3. Run Mode (stata-all-in-one.runMode)

   • embeddedConsole (default): Run code in the built-in Console | Stata All in One panel within VS Code, with direct output viewing and interaction.
   • externalApp: Send code to the system-installed Stata application for execution.

4. Stata Version on macOS (stata-all-in-one.stataVersionOnMacOS)

   • Stata runtime version. Choose from StataMP, StataSE, StataIC, or StataBE.

5. Stata Path on Windows (stata-all-in-one.stataPathOnWindows)

   • Path to Stata executable file (e.g., C:\Program Files\Stata17\StataMP-64.exe).

6. Close Stata Other Windows Before Sending Code (Windows) (stata-all-in-one.closeStataOtherWindowsBeforeSendingCode)

   • true: Close Stata helper windows (such as Viewer/Data Editor) before sending run commands.
   • false (default): Keep those windows open and send code directly.

7. Auto cd to Do File Directory (stata-all-in-one.cdToDoFileDir)

   • true (default): Automatically set Stata's working directory to the do file's location on first launch.
   • false: Stata's working directory is not changed on startup.

8. Show Run Button (stata-all-in-one.showRunButton)

   • true (default): Show the run button in the editor title bar.
   • false: Hide the button.

9. Show Action Buttons (stata-all-in-one.showActionButtons)

   • true (default): Show the "Bug Report" and "Sponsor" buttons in the editor title bar.
   • false: Hide these buttons.

10. Enable Ctrl+Shift+D for Run Shortcut (stata-all-in-one.enableCtrlShiftD)

    • true: Use Ctrl/Cmd+Shift+D as the run code shortcut.
    • false (default): Use the default Ctrl/Cmd+D shortcut.

Embedded Console

11. Console Font Mode (stata-all-in-one.consoleFontMode)

    • editor (default): Follow the editor font, falling back to the system monospace font.
    • system: Use the system monospace font directly.
    • custom: Use the custom font specified below.

12. Console Custom Font Family (stata-all-in-one.consoleCustomFontFamily)

    • When font mode is set to custom, the CSS font-family list used by the console.
    • Example: "Maple Mono NF CN", Menlo, Monaco, monospace

13. Graph Export DPI (stata-all-in-one.graphPngDpi)

    • DPI value for saving embedded console graphs as PNG. Default 600, range 72–1200.

Syntax Highlighting and Code Completion

14. Custom Command Highlighting (stata-all-in-one.customCommands)
    • User-defined Stata commands to highlight as keywords (array of strings). Default: reghdfe.
    • Example: ["reghdfe", "ivreghdfe", "gtools", "winsor2", "outreg2"]
    • Requires reloading window after configuration.

Hover Help

15. Enable Hover Docs (stata-all-in-one.enableHoverDocs)

    • true (default): Show official Stata help information when hovering over Stata commands.
    • false: Disable hover help.

16. Additional ADO Paths (stata-all-in-one.additionalAdoPaths)

    • Extra Stata ADO paths for scanning help files of community-contributed commands.
    • Example: ["/Users/username/ado/personal", "C:\\Users\\username\\ado\\personal"]

Outline & Navigation

17. Display Multi-level Numbering (stata-all-in-one.numberingShow)

    • true: Outline displays 1.1, 1.2.1 style numbering.
    • false (default): Displays original headings.

18. Auto-update Heading Numbering (stata-all-in-one.numberingAdd)

    • true: When numbering is enabled, automatically update section titles in .do files to include numbers.
    • false (default): Only displays numbering in outline, doesn't modify file.

Note: Changes to numberingShow, numberingAdd, and customCommands require reopening .do files to take effect. When numberingAdd is disabled, existing numbering in .do files will be automatically removed.

Code Style

19. Comment Style (stata-all-in-one.commentStyle)

    • // (default): Comment style used for toggling comments. Options include //, *, or /* ... */

20. Separator Length (stata-all-in-one.separatorLength)

    • Total character length of the separator line (including the ** # prefix and separators). Default: 60

21. Separator Symmetric (stata-all-in-one.separatorSymmetric)
    • true: Add ** at the end of separator lines to ensure visual symmetry (e.g., ** === Title === **).
    • false (default): Separator lines without the suffix.

Buy me a coffee

If this extension has been helpful to you, feel free to scan the Alipay (left), WeChat (middle), or Buy Me a Coffee (right) QR code below to support ☕

Changelog

See CHANGELOG.md for full version history.