Code Smeller Guide

Complete installation and usage guide for the Code Smeller VS Code extension

Installation & Setup

Install from Marketplace

In VS Code, open the Extensions view (Ctrl+Shift+X), search for "Code Smeller" by Tolulope Jegede, and click Install.

Quick Open Method

Launch VS Code Quick Open (Ctrl+P), paste the command and press Enter:

ext install TolulopeJegede.code-smeller

Initial Setup

After installation, if you want AI-powered code reviews, get a free Gemini API key and save it via Code Smeller's settings (use the Set Gemini API Key command in VS Code).

Note: Code Smeller works out-of-the-box for supported languages. The Gemini API key is only needed for optional LLM-based reviews.

Using Code Smeller

Automatic Analysis

Open a source file (JavaScript, TypeScript, Python). Code Smeller automatically starts analyzing it with a side panel showing live suggestions.

Smell Score Indicator

Check the bottom-left status bar for a smell score icon (1–5). Hover to see a themed One Piece quote for that score.

Real-time Feedback

Code Smeller updates suggestions and smell scores in real-time as you type, without interrupting your workflow.

AI-Powered Review

For deeper insights, trigger the Smell Code command from the Command Palette for an LLM-powered analysis.

Smell Score System

Each code review gets a Smell Score from 1 (clean) to 5 (disaster). Every level has a custom One Piece-themed quote from Luffy and his crew:

1 Squeaky clean

"Shishishi~! This code's tighter than anchor rope!"

2 Slightly off

"Oi... it's decent, but somethin's off in the wind."

3 Needs cleanup

"It's not the worst, but it needs serious polish."

4 Smelly

"Too much goin' on — clean it up or we'll sink!"

5 Code is lethal

"THIS CODE'S A DISASTER! PATCH THE HOLES!!"

Commands

Access these via the VS Code Command Palette (Ctrl+Shift+P) by searching "Code Smeller":

Smell Code

Runs a Gemini AI-powered code review on the current file (on-demand analysis).

Code Smeller: Set Gemini API Key

Prompts you to securely store your Gemini API key using VS Code's SecretStorage.

Code Smeller: Add Language To Supported Languages

Adds the current file's language ID to Code Smeller's supported list (enabling live analysis).

Security Note

Code Smeller uses VS Code's secure SecretStorage to keep your API key safe. Your Gemini API key is never stored in plain text, and you can update or remove it any time via the provided commands.