EkLine VSCode Integration
Integrate EkLine directly into Visual Studio Code to enforce style guides, receive immediate feedback, and ensure documentation consistency.
Prerequisites
Section titled “Prerequisites”Active EkLine account and Integration Token.
Note: Retrieve your token from the EkLine Dashboard by clicking View Integration Token.
Supported file types
Section titled “Supported file types”The extension works with the following file types:
- Markdown (
.md) - MDX (
.mdx) - HTML (
.html) - reStructuredText (
.rst) - Plain text (
.txt) - AsciiDoc (
.adoc)
Installation
Section titled “Installation”Choose one of the following methods to install the extension.
Method 1: VSCode Marketplace (Recommended)
- Open Visual Studio Code.
- Navigate to the Extensions view (Activity Bar).
- Search for
EkLine. - Click Install.
Method 2: Web Browser
- Visit the EkLine Extension Page.
- Click Install.
Configuration
Section titled “Configuration”1. Authentication
Section titled “1. Authentication”Upon installation, a prompt appears requesting your integration token.
- Enter your EkLine Integration Token.
- Press
Enterto activate.
If you miss the prompt: Open the Command Palette (Cmd/Ctrl + Shift + P) and run EkLine: Configure Extension.
2. Workspace settings
Section titled “2. Workspace settings”Access configuration via Settings > Extensions > EkLine or by editing your .vscode/settings.json.
| Setting | Description | Default |
|---|---|---|
| EkLine Token | Your unique integration key. You can set it at the User or Workspace level. | N/A |
| Documentation Paths | Array of directories to review relative to workspace root. Add paths in VS Code settings UI or as a JSON array in settings.json. | ["src"] |
| Style Guide | Select the standard for review (Google, Microsoft, Marketing, or Custom). | Google |
| Disabled | Toggle to disable the extension without uninstalling it. | false |
| Debug | Enable debug mode for troubleshooting. | false |
Usage & commands
Section titled “Usage & commands”EkLine runs automatically on supported files when opened or saved. You can also trigger reviews manually.
Core commands
Section titled “Core commands”Access these via the Command Palette (Cmd/Ctrl + Shift + P).
| Command | Function |
|---|---|
EkLine: Review all documents | Analyzes all files in the configured paths. |
EkLine: Review current document | Analyzes only the active file. |
EkLine: Improve writing in current file | Triggers EkLine AI to enhance the active file’s content. |
EkLine: Configure Extension | Opens the token configuration prompt. |
Keyboard shortcuts
Section titled “Keyboard shortcuts”| Shortcut | Context | Action |
|---|---|---|
Cmd+Alt+E (Mac) / Ctrl+Alt+E (Windows/Linux) | Text selected | Opens Ask EkLine with the selected text |
Cmd+Alt+E (Mac) / Ctrl+Alt+E (Windows/Linux) | No selection, cursor on empty line | Opens prompt to add content at cursor position |
AI assistant (Ask EkLine)
Section titled “AI assistant (Ask EkLine)”Use the AI assistant to generate content or refactor existing text. Select text and right-click to choose Improve with EkLine AI.
1. Refactoring text
Section titled “1. Refactoring text”- Highlight the text to improve.
- Right-click and select Improve with EkLine AI.
- Input your instruction and press
Enter. - Review the Diff View and accept (
✓) or reject (✗) changes.
2. Generating content
Section titled “2. Generating content”- Place cursor on an empty line.
- Right-click and select Improve with EkLine AI.
- Enter prompt to generate text at that location.
3. Contextual prompts
Section titled “3. Contextual prompts”Reference specific files to give the AI context:
- In Input Box: Type
@followed by the filename (for example,@utils.ts). - In Editor: Type
@eklinefollowed by a prompt directly in the file. Click the appearing CodeLens to execute.
EkLine suggestions panel
Section titled “EkLine suggestions panel”The extension adds an EkLine icon to the Activity Bar (left sidebar). Click it to open the EkLine Suggestions panel, which displays:
- Real-time linting suggestions for the current file
- AI assistant interface for quick improvements
Diff view
Section titled “Diff view”When EkLine AI suggests changes, they appear in a side-by-side diff view:
- Accept (
✓): Click the checkmark button in the editor title bar to apply changes. - Reject (
✗): Click the X button to discard changes
The diff view lets you review AI-suggested improvements before applying them to your document.