Soul Language Extension for VS Code

Comprehensive Visual Studio Code support for the Soul programming language - a modern, dynamically typed scripting language designed for AI automation, web scraping, and system integration.
✨ Features
🎨 Rich Syntax Highlighting
- Complete Soul language syntax support
- Beautiful dark theme optimized for Soul code
- Proper highlighting for sanctuaries (classes), oasis (traits), and soul functions
- Comment, string, and operator highlighting
🧠 Intelligent Code Completion
- Smart IntelliSense for Soul keywords and built-in functions
- Class-aware completions - get method suggestions when typing
MyClass.
- Built-in module support - completions for
console
, http
, ai
, math
, json
, spirit
, and more
- User-defined function suggestions - automatically detects and suggests your custom functions
- Constructor patterns - smart suggestions for static vs regular sanctuaries
📖 Hover Documentation
- Comprehensive documentation for built-in functions
- Parameter information and usage examples
- User-defined function signatures with line numbers
- Module method documentation (e.g.,
console.log
, http.get
, spirit.abort
)
🔍 Go to Definition
- Jump to function definitions with F12 or Ctrl+Click
- Navigate to class and method declarations
- Works with both built-in and user-defined symbols
- Format on Save support with proper Soul indentation
- Automatic code beautification with consistent spacing
- Smart indentation for nested blocks and control structures
📝 Code Snippets
- Quick insertion of common Soul patterns:
soul function
- Creates a Soul function template
async soul function
- Creates an async Soul function
sanctuary class
- Creates a Soul class (sanctuary) template
oasis trait
- Creates a Soul trait (oasis) template
🚀 Soul Language Overview
Soul is a powerful scripting language with modern features designed for AI automation, web scraping, and system integration.
Key Language Features:
- Sanctuaries - Object-oriented classes with constructors (
__genesis__
)
- Oasis - Trait system for shared behavior
- Built-in AI modules - Direct integration with Anthropic, OpenAI, Gemini
- HTTP & WebSocket support - Built-in networking capabilities
- Async/await - Modern asynchronous programming
- Channels & Select - Go-style concurrency primitives
📋 Installation
From VS Code Marketplace:
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X
)
- Search for "Soul Language"
- Click Install
From Command Line:
- Run:
code --install-extension gantz-ai.soul-language
⚙️ Configuration
The extension works out of the box with sensible defaults. Available settings:
- soul.formatOnSave: Enable/disable format on save (default: true)
- soul.insertSpaces: Use spaces instead of tabs (default: true)
- soul.tabSize: Number of spaces per indentation level (default: 4)
- Format on Save is enabled by default for
.soul
files
- Uses 4 spaces for indentation (configurable)
- Automatically detects and preserves your indentation style
📚 Supported File Extensions
.soul
- Soul source files
🎨 Themes
The extension includes a custom Soul Dark theme optimized for Soul syntax highlighting. It provides excellent contrast and readability for all Soul language constructs.
🐛 Known Issues
- Comment formatting improvements are ongoing
- Additional built-in modules will be added in future releases
📖 Documentation & Resources
🤝 Contributing
We welcome contributions! Please feel free to:
- Report bugs and request features via GitHub Issues
- Submit pull requests for improvements
- Share feedback and suggestions
📄 License
This extension is licensed under the MIT License.
Happy coding with Soul! 🚀
Made with ❤️ for the Soul programming language community