SyntraX

AI Coding Assistant for VS Code

Create  ·  Scan  ·  Fix  ·  Delete — just by typing

🚀 Build, fix, and manage your code using natural language — powered by Gemini AI inside VS Code.

✨ What is SyntraX?

SyntraX is an AI-powered coding assistant that lives right inside your VS Code sidebar. Instead of writing boilerplate, debugging manually, or fixing code line-by-line — you just type what you want in plain English and SyntraX does the work using Google Gemini 2.5 Flash AI.

No subscriptions. No complex setup. Just a free Gemini API key and you're ready to go.

💡 Why SyntraX?

• 🔥 Actually edits your files — not just suggestions
• ⚡ Works on entire folders — scan, fix, create all at once
• 🧠 Uses Gemini Function Calling — real execution, not guessing
• 👁️ Opens diff view so you review every change before saving
• 🔒 Secure API key storage via VS Code encrypted secrets
• 🆓 Completely free to use with a free Gemini API key

⚡ Features at a Glance

🚀 Getting Started

1️⃣ Install SyntraX

Open VS Code Extensions (Ctrl+Shift+X) → Search SyntraX → Click Install

2️⃣ Get a Free Gemini API Key

SyntraX uses Google Gemini AI which is completely free to use.

1. Go to 👉 aistudio.google.com/app/apikey
2. Sign in with your Google account
3. Click Create API Key
4. Copy the key (starts with AIzaSy...)

3️⃣ Activate SyntraX

1. Click the SyntraX eye icon in the VS Code Activity Bar (left sidebar)
2. Paste your Gemini API key in the input field
3. Click Activate
4. SyntraX validates your key automatically — if it's wrong, you'll see an error

4️⃣ Open a Folder and Start Typing

Open any project folder in VS Code (File → Open Folder) and type your first command:

create portfolio website inside myfolder
scan src folder
fix myproject folder

⚙️ How It Works Internally

SyntraX uses Gemini Function Calling — the AI doesn't guess at your code. It actually calls real tools to read, fix, and write your files on disk.

You type a command in SyntraX chat
              ↓
Text is sent to Google Gemini 2.5 Flash API
              ↓
Gemini decides which tools to use
              ↓
SyntraX tools execute on your local files:
  • list_files    — scans your folder
  • read_file     — reads each file
  • write_file    — writes fixes
  • create_folder — creates directories
              ↓
Results appear in sidebar
Diff view opens for every fixed file

SyntraX actually reads your code before making any change. It never guesses.

📸 How Each Feature Works

⚡ Create — Generate Full Projects

Type a natural language request and SyntraX generates a complete, working project.

Example:

create a calculator website inside myproject folder

SyntraX will:

1. Create the myproject folder
2. Generate index.html with full markup
3. Generate style.css with modern styling
4. Generate script.js with complete working logic

All code is production-ready — no TODO comments, no placeholder text.

🔍 Scan — Find Issues in Your Code

SyntraX reads every file in your folder and produces a detailed report with exact file names and line numbers.

Example:

scan myproject folder

Sample Scan Report:

SCAN REPORT
Files scanned: 3  |  Security: 1  |  Bugs: 2  |  Quality: 1  |  HTML/CSS: 1

index.html
  L1    SEC     Missing DOCTYPE declaration
  L14   BUG     img tag missing alt attribute

script.js
  L23   SEC     innerHTML used — XSS vulnerability risk
  L47   BUG     console.log left in production code

style.css
  L12   STYLE   Magic number used instead of CSS variable

Severity levels:

• SEC — Security issue (XSS, injection, exposed tokens)
• BUG — Logic error, missing check, broken code
• STYLE — Code quality (unused vars, duplicate rules)
• HTML — HTML/CSS structure issues

🛠️ Fix — Auto-Fix All Issues with Diff Preview

SyntraX reads every file, fixes every issue, and opens a side-by-side diff view in VS Code so you can review every single change before saving.

Example:

fix myproject folder

SyntraX will:

1. List all files in the folder
2. Read each file one by one
3. Fix all issues found
4. Write the complete corrected file
5. Open diff view — green = added, red = removed

💬 Chat — Ask Anything About Code

SyntraX remembers your conversation history so you can have a real back-and-forth discussion.

explain what async/await does
why is my for loop not working?
what is the difference between == and ===
how do I optimize this algorithm?

🗑️ Delete — Remove Files or Folders

delete myproject folder

Permanently removes the specified file or folder. This cannot be undone — use carefully.

⚠️ Free Gemini API — What You Should Know

SyntraX runs on Google's free Gemini API tier, which has some limits worth understanding:

If something goes wrong: Click the 🗑️ trash icon to clear the chat and start fresh.

🔑 API Key — Common Issues & Fixes

⚠️ Never put your API key in .env files or commit it to GitHub. SyntraX stores it securely in VS Code's encrypted secret storage — let it handle the key for you.

💡 Pro tip: If you keep hitting rate limits on large projects, break them into smaller folders and scan/fix one at a time.

⌨️ Keyboard Shortcuts

💡 Tips for Best Results

• Be specific about folder names — use the exact name that exists in your workspace
• Fix entire folders at once — fix myapp folder fixes ALL files, not just one
• Scan before fixing — scan first to see what issues exist, then fix
• Stop anytime — if a task is taking too long, click the Stop button
• Clear chat if stuck — if something goes wrong, clear chat and try again

📋 Requirements

• VS Code version 1.80.0 or higher
• Internet connection — needed for Gemini API calls
• Free Google Gemini API key — get one at aistudio.google.com

🔒 Privacy & Data

🛣️ Roadmap

• [x] Chat with Gemini AI
• [x] Code scan & analysis with line numbers
• [x] Auto-fix with before/after diff view
• [x] AI code generation (full projects)
• [x] Secure API key storage with validation
• [x] Chat persistence across sessions
• [x] Live progress streaming + Stop button
• [ ] OpenAI / Claude support
• [ ] Inline diagnostics (like ESLint)
• [ ] Git integration
• [ ] Test generation
• [ ] Multi-file context awareness

🧪 Run Locally

git clone https://github.com/shubham-17p/SyntraX
cd SyntraX
npm install
code .
# Press F5 to launch Extension Development Host

📦 Build & Publish

npm install -g @vscode/vsce
vsce package
vsce publish

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

MIT License — Copyright (c) 2025 Shubham Patel

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software to deal in the Software without restriction, including the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, subject to the above copyright notice appearing in all copies.

What this means:

• ✅ Free to use, modify, and distribute
• ✅ Commercial use allowed
• ❌ Only requirement — give credit (keep the copyright notice)

❤️ Support

• ⭐ Star the repo on GitHub
• 🐛 Report issues or bugs
• 💡 Suggest new features