AI Terminal v6 — VS Code Extension

Chat-style AI terminal assistant — all in one VS Code window. Paste any API key, type what you want, see the command, click Run.

---

What's new in v6

Feature	v5	v6
UI	Input box popups	Built-in chat panel (opens beside your editor)
Window	Required second window	One window — no F5 needed after install
JSON parse errors	Could fail (Groq/Llama)	Fixed — handles messy JSON & markdown
Run commands	Auto-ran immediately	Click Run or Copy

---

How it works

You type:    "create a folder named vaibhav on the Desktop"

AI replies:  New-Item -ItemType Directory -Path "$env:USERPROFILE\Desktop\vaibhav"

             [Run in Terminal]  [Copy]

Click Run → command executes in the VS Code terminal

---

Supported API Keys (Auto-detected)

Provider	Key Prefix	Free
Google Gemini	AIza...	Yes
Groq	gsk_...	Yes
OpenAI	sk-... / sk-proj-...	No
Anthropic Claude	sk-ant-...	No
OpenRouter	sk-or-...	Yes
Mistral	32-char key	Yes
Cohere	Long key	Yes

---

Setup

Prerequisites

Tool	Check	Install
Node.js 18+	node -v	https://nodejs.org
VS Code	—	https://code.visualstudio.com

---

1. Get API Key

• Groq → https://console.groq.com

---

2. Open Project

cd ai-terminal-v5
code .

---

3. Install & Build

npm install
npm run watch

Wait for:

[watch] build finished, watching for changes...

---

4. Launch (Dev Mode)

Press:

F5

---

5. Open Chat Panel

• Ctrl + Shift + ; (Mac: Cmd + Shift + ;)
• OR click AI Terminal in the status bar
• OR Command Palette → AI Terminal: Open

---

6. Paste API Key

• Paste → Click Connect
• Provider auto-detected

---

Usage

Action	How
Ask AI	Type → Enter
Run command	Run in Terminal
Copy command	Copy
Change API key	Key button
Clear chat	Clear button
Override model	VS Code settings

---

Install Permanently (No F5)

npm install -g @vscode/vsce
vsce package
code --install-extension ai-terminal-6.0.0.vsix

---

Troubleshooting

Panel not opening

Ensure build finished before pressing F5

API error 401

Invalid or expired key → paste new key

Unknown API key format

Can still proceed (OpenAI-compatible)

Changes not reflecting

Ctrl + Shift + P → Reload Window

---

Settings

Setting	Description	Default
aiTerminal.model	Override model	auto
aiTerminal.shell	Shell type	auto

---

Project Structure

ai-terminal-v5/
├── src/
│   ├── extension.ts
│   ├── panelContent.ts
│   ├── llmProvider.ts
│   └── terminalExecutor.ts
├── out/
├── package.json
└── tsconfig.json

---