Skip to content

Repository files navigation

Semantica 🧠✨

The AI-Powered Linter that understands your intent.

Semantica is a next-generation linter for VS Code that leverages the power of GitHub Copilot and Large Language Models (LLMs) to validate your code against natural language rules.

Standard linters (ESLint, Pylint) rely on rigid AST parsers or complex Regex. Semantica uses AI to understand the meaning of your code, allowing you to enforce high-level architectural patterns, semantic naming conventions, and best practices that static tools simply cannot see.

🚀 Features

Semantica in Action

  • 🧠 AI-Driven Validation: Define rules like "Use semantic variable names" or "Always handle promises with a catch block".
  • 🗣️ Plain English Config: No more writing custom ESLint plugins. Just write what you want in plain text.
  • ✨ Context-Aware Fixes: The "Fix All" button doesn't just do string replacement; it lets the AI refactor your code intelligently to meet your standards.
  • 🔒 Privacy First: Uses your existing GitHub Copilot subscription via the VS Code Language Model API. Your code stays within your secure enterprise trust boundary.
  • ⚡ Zero Configuration: Works instantly with reasonable defaults, or customize it to your heart's content.

📦 Usage

  1. Install the extension.

  2. Open a file in any supported language (TS, JS, Python, Go, Rust, Java, C#, C++).

  3. Define Rules:

    Option 1: VS Code Settings (Ctrl+,)

    • Search for semantica.
    • Add your rules to the list.

    Semantica Settings

    Option 2: Project File .semantica

    • Create a .semantica file in your project root:
      1. Variable names must be descriptive (no x, y, temp).
      2. Do not use console.log; use the logger service.
      3. All interfaces must start with 'I'.
  4. Lint: Violations appear as warnings in your editor.

  5. Fix: Use the Quick Fix (💡) to fix one or all issues instantly.

    Semantica Quick Fix

🔧 Requirements

  • VS Code ^1.90.0
  • GitHub Copilot Chat Extension installed and active.

🤝 Contributing

This is an open source project! Repository: https://github.com/YoavLax/semantica

📄 License

MIT © Yoav Lax

About

The AI-Powered Linter for VS Code. Define coding standards in plain English and let GitHub Copilot enforce them by understanding your code's intent.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages