Zeno for Visual Studio Code

Official Visual Studio Code Language Support for Zeno

Rich syntax highlighting, run commands, inline diagnostics, formatting, code snippets, and IntelliSense for Zeno (.zeno).

Features

• 🎨 Syntax Highlighting: Modern TextMate grammar colorizing keywords (say, ask, repeat, function, end), built-in functions, strings, numbers, operators, and comments.
• ▶ 1-Click Execution: Integrated Run Button in the editor title bar and Ctrl+F5 keybinding.
• ⚡ Real-Time Diagnostics: Inline syntax checking powered by zeno check connected directly to the VS Code Problems panel.
• 📐 Document Formatting: Full support for Format Document (Shift+Alt+F) and Format on Save.
• 💡 IntelliSense & Hover Docs: Rich autocompletions and hover documentation for all keywords, built-ins (length, trim, split, etc.), and standard modules (crypto, network, file, http, etc.).
• 📝 Code Snippets: Expandable templates for control flows, loops, functions, exception handling, and cybersecurity scripts.
• 📂 File Icon Theme: Official Zeno logo branding for .zeno files in the VS Code File Explorer.
• 🔒 Secure Offline-First Architecture: Completely functional offline with secure credential scaffolding via VS Code SecretStorage.

Quick Start

1. Install Zeno Runtime

Ensure the official Zeno package is installed in your Python environment:

python -m pip install zeno

Verify your installation:

zeno --version

2. Install the Extension

In VS Code:

1. Open the Extensions view (Ctrl+Shift+X).
2. Click ... (Views and More Actions) at the top right of the Extensions panel.
3. Select Install from VSIX....
4. Choose zeno-language-support-1.0.0.vsix.

Alternatively, via command line:

code --install-extension vscode-extension/zeno-language-support-1.0.0.vsix

3. Open and Run .zeno Files

Create a file named hello.zeno:

# Hello World in Zeno
name = ask "What is your name? "
say "Hello, " + name + "! Welcome to Zeno."

repeat 3 as i
    say "Countdown: " + string(i + 1)
end

Click the ▶ Run button at the top-right of the editor, or press Ctrl+F5 to execute!

Available Commands

Access these commands from the Command Palette (Ctrl+Shift+P):

Extension Settings

Customize extension behavior in Settings (Ctrl+, -> Search Zeno):

• zeno.executablePath: Custom absolute path to the zeno CLI executable (automatically discovered if omitted).
• zeno.pythonPath: Custom path to the Python interpreter containing the zeno package.
• zeno.enableDiagnostics: Enable/disable real-time error reporting in the Problems panel (default: true).
• zeno.showRunButton: Display the Run button in the editor navigation bar (default: true).
• zeno.accountEnabled: Enable/disable the Account status indicator (default: true).

Troubleshooting

"Zeno runtime was not detected"

1. Make sure Python 3.8+ is installed on your system.
2. Install the package using:

   python -m pip install zeno
   

3. If you are using a virtual environment (.venv), ensure the environment is active or set zeno.pythonPath in VS Code settings to point to your virtual environment's Python executable.
4. Click the status bar item $(alert) Zeno: Not Found to re-check or configure the path.

License

MIT License © 2026 Zeno Programming Language Contributors