Skip to content

Chuks for Visual Studio Code

Welcome to the official Visual Studio Code extension for the Chuks programming language. This extension provides rich language support powered by the built-in Chuks LSP server.

Features

Core

Syntax Highlighting — colorization for Chuks keywords, types, operators, and structures
IntelliSense — smart code completion and suggestions
Diagnostics — real-time error checking and warnings as you type
Hover Documentation — type info and docs on mouse hover
Go to Definition — jump to symbol definitions (F12 / Cmd+Click)
Snippets — code templates for common patterns (httpserver, jwtauth, testsuite, etc.)

Find All References — locate every usage of a symbol across your project (Shift+F12)
Go to Type Definition — jump to the type behind a variable or parameter
Workspace Symbol Search — search symbols across all open files (Cmd+T / Ctrl+T)
Folding Ranges — collapse/expand code blocks, import sections, and comments

Refactoring

Rename Symbol — rename a variable, function, or class across the project (F2)
Organize Imports — sort and deduplicate import statements (Cmd+Shift+P → "Organize Imports")

Code Quality

Code Lens — clickable reference counts shown above classes, interfaces, and functions
Inlay Hints — inferred type annotations shown inline for untyped var declarations
Semantic Highlighting — richer token coloring based on compiler analysis

Project Management

Document Formatting — auto-format Chuks files with consistent indentation (Shift+Alt+F / Shift+Option+F)
Build & Run — commands to create, build, and run Chuks projects

Keyboard Shortcuts

Feature	macOS	Windows/Linux
Go to Definition	`F12` or `Cmd+Click`	`F12` or `Ctrl+Click`
Find All References	`Shift+F12`	`Shift+F12`
Rename Symbol	`F2`	`F2`
Go to Type Definition	`Cmd+Click` on type	`Ctrl+Click` on type
Workspace Symbol Search	`Cmd+T`	`Ctrl+T`
Format Document	`Shift+Option+F`	`Shift+Alt+F`
Toggle Folding	`Cmd+Shift+[` / `]`	`Ctrl+Shift+[` / `]`
Organize Imports	`Cmd+Shift+P` → "Organize Imports"	`Ctrl+Shift+P` → "Organize Imports"

Requirements

Chuks CLI v0.0.7+: Ensure the chuks command-line tool is installed and available in your PATH. The LSP server is built into the compiler.

Extension Settings

chuks.enable: Enable/disable this extension.
chuks.executablePath: Path to the chuks CLI executable (optional).
editor.inlayHints.enabled: Set to "on" or "onUnlessPressed" to see inlay type hints.

Known Issues

None at this time.

Release Notes

See CHANGELOG.md for full release history.