Overview
EpiStyle integrates the official Epitech coding style checker directly into Visual Studio Code. It runs automatically in the background and surfaces violations inline, in the Problems panel, and with detailed explanations — so you can fix issues before they ever reach a moulinette.
Preview
Inline diagnostics with rule codes and plain-language descriptions, shown alongside Error Lens.
Features
- Real-time analysis — Style checks run automatically on file save
- Fast — A persistent background container keeps per-save latency in milliseconds
- Inline diagnostics — Warnings appear in the Problems panel and inline
- Detailed explanations — Every violation comes with a clear description
- Customizable — Toggle the checker on or off from settings or the status bar
- Gitignore-aware — Respects ignored files and directories
- Zero configuration — Install, open a C project, and start coding
Tip: Pair EpiStyle with Error Lens for inline highlighting of warnings.
Requirements
Any Docker-compatible runtime works — Docker Desktop, OrbStack, Colima, Rancher Desktop, or a native dockerd on Linux. Make sure it is running before launching VS Code.
Installation
- Install Docker and make sure the daemon is running
- Open VS Code, head to the Extensions panel, and search for
EpiStyle — or grab it directly from the Marketplace
- Reload VS Code and open any C project — EpiStyle starts watching automatically
Usage
Save any .c, .h, or Makefile and EpiStyle takes over:
- Style violations appear in the Problems panel
- Inline diagnostics highlight the offending lines
- Each entry includes the rule reference and a short explanation
No commands to run, no flags to remember.
Configuration
| Setting |
Default |
Description |
epitech-coding-style.enable |
true |
Enable or disable real-time style checks |
epitech-coding-style.persistLogFile |
false |
Keep .vscode/coding-style-reports.log after each analysis run |
epitech-coding-style.excludePaths |
["tests/"] |
Gitignore-style patterns to exclude from analysis (applied on top of .gitignore) |
Open VS Code settings (Cmd/Ctrl + ,) and search for EpiStyle to adjust.
Commands
Open the command palette (Cmd/Ctrl + Shift + P) and type EpiStyle to access:
| Command |
Description |
EpiStyle: Restart Checker Containers |
Stops the background checker container, re-pulls the latest official image, and starts fresh. Use it after upstream updates. |
Known Issues
- Performance may degrade on very large projects
- Non-standard project structures may require additional configuration
Contributing
Contributions are welcome. Open an issue or submit a pull request on the GitHub repository.
Disclaimer
EpiStyle is an independent, community-maintained open-source project and is not affiliated with, endorsed by, or sponsored by Epitech. "Epitech" is a trademark of its respective owner. This extension is a thin wrapper around the publicly available Epitech/coding-style-checker Docker image, which is pulled directly from Epitech's official registry on the user's machine — EpiStyle neither bundles nor redistributes it.
License
Distributed under the MIT License — © Maty MILLIEN
