⚡ VibeCode — AI Development Terminal

Your AI pair programmer, right in your terminal

Stop switching between ChatGPT and your IDE. VibeCode — AI Development Terminal brings GPT-4 and Claude directly to your command line.

# 1. Clone VibeCode — AI Development Terminal
git clone https://github.com/ArthurDS-tech/Vibecoder-Claude.git
cd Vibecoder-Claude

# 2. Build and install
npm install && npm run build && npm install -g .

# 3. Start coding
vibecode

🚀 Quick Start • ✨ Features • 📦 Install • 🎯 Commands • ⚙️ Config

🎬 See VibeCode — AI Development Terminal in Action

$ vibecode

  ╭─────────────────────────────────╮
  │      VibeCode  AI               │
  ╰─────────────────────────────────╯

  AI-powered development terminal
  v1.0.0 • Connected to Claude · Sonnet

  Quick Start
  → vibe "your task here"
  → help for all commands
  → switch to change AI provider

myproject › vibe "add error handling to auth.ts"

◐ Entendendo comando...
✓ Entendendo comando
◐ Analisando projeto...
✓ Analisando projeto
◐ Executando ações...
✓ Executando ações

━━━ RESULTADO ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

� ANÁLISE
Identificado: Falta tratamento de erros em operações assíncronas
Solução: Adicionar try-catch e validação de entrada

✨ MUDANÇAS
• Adicionado try-catch em todas as funções async
• Validação de token JWT antes de processar
• Mensagens de erro específicas para cada caso
• Logging de erros para debug

💻 CÓDIGO
Arquivo: src/auth.ts
[código completo com melhorias...]

🚀 PRÓXIMOS PASSOS
• Testar com tokens inválidos
• Adicionar testes unitários
• Documentar novos error codes

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️  Executar ações automaticamente? (s/n): s

━━━ EXECUTANDO AÇÕES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✓ Modificado: src/auth.ts

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

myproject ›

🔥 Why VibeCode — AI Development Terminal?

⚡ Lightning Fast

No more copy-paste between ChatGPT and your IDE.

VibeCode — AI Development Terminal understands your project context automatically.

vibe "optimize this function"
# ✓ Done in 3 seconds

🎯 Context-Aware

VibeCode — AI Development Terminal reads your:

Project structure
Dependencies
Code style
Git history

No need to explain your codebase every time.

🤖 Multi-AI Support

Switch between AI providers instantly:

OpenAI GPT-4 - Most powerful
Claude 3.5 Sonnet - Best for code
GPT-4 Turbo - Fastest & cheapest

switch  # Interactive menu

💰 Token Tracking

VibeCode — AI Development Terminal tracks your API usage:

Real-time cost monitoring
Budget alerts
Usage history
Cost optimization tips

Never overspend on AI APIs again.

🔒 Secure by Default

API keys never exposed in logs
Automatic key masking
Local configuration only
No data sent to third parties

Your code stays private.

🎨 Beautiful UX

Clean, minimal interface inspired by Claude Code.

VibeCode — AI Development Terminal feels like a native tool, not a chatbot.

No clutter. Just results.

🚀 Quick Start

⚠️ Important: Clone to Local Drive (Not Network Drive)

VibeCode — AI Development Terminal requires a local directory. Network drives (Z:\, \\server\...) cause Git issues.

1️⃣ Clone to Local Directory

# Windows - Use C: drive
cd C:\Users\YourUser\Documents
git clone https://github.com/ArthurDS-tech/Vibecoder-Claude.git
cd Vibecoder-Claude

# Linux/Mac
cd ~/projects
git clone https://github.com/ArthurDS-tech/Vibecoder-Claude.git
cd Vibecoder-Claude

2️⃣ Install VibeCode — AI Development Terminal

# Install dependencies
npm install

# Build VibeCode — AI Development Terminal
npm run build

# Install globally
npm install -g .

# Verify installation
vibecode --version

3️⃣ Configure Your API Key

# Start VibeCode — AI Development Terminal
vibecode

# Set your API key
config set apiKey YOUR_API_KEY

# Choose provider
config set provider anthropic  # or openai

Get your API key:

OpenAI: https://platform.openai.com/api-keys
Anthropic: https://console.anthropic.com/

4️⃣ Start Using VibeCode — AI Development Terminal

vibe "create a REST API with authentication"
vibe "refactor this code using best practices"
vibe "add tests to Button component"
vibe "fix the bug in auth.ts"

That's it! VibeCode — AI Development Terminal handles the rest.

✨ What Can VibeCode — AI Development Terminal Do?

🏗️ Build

vibe "create a React component"
vibe "add API endpoint"
vibe "setup database schema"

🐛 Debug

vibe "fix this error"
vibe "why is this slow?"
vibe "find memory leaks"

⚡ Optimize

vibe "improve performance"
vibe "reduce bundle size"
vibe "optimize queries"

🔄 Refactor

vibe "use TypeScript"
vibe "apply SOLID principles"
vibe "modernize this code"

🧪 Test

vibe "add unit tests"
vibe "create test cases"
vibe "mock this API"

📚 Document

vibe "add JSDoc comments"
vibe "write README"
vibe "explain this code"

📦 Installation

Method 1: From Source (Recommended)

# ⚠️ IMPORTANT: Clone to LOCAL drive (C:\, not Z:\ or network drive)
cd C:\Users\YourUser\Documents

# Clone VibeCode — AI Development Terminal
git clone https://github.com/ArthurDS-tech/Vibecoder-Claude.git
cd Vibecoder-Claude

# Install dependencies
npm install

# Build VibeCode — AI Development Terminal
npm run build

# Install globally
npm install -g .

# Verify installation
vibecode --version

Method 2: Quick Install Script (Windows)

# Run PowerShell as Administrator
cd C:\Users\YourUser\Documents
git clone https://github.com/ArthurDS-tech/Vibecoder-Claude.git
cd Vibecoder-Claude
.\install-global.ps1

This script automatically:

✅ Builds VibeCode — AI Development Terminal
✅ Installs globally
✅ Adds to Windows PATH
✅ Verifies installation

Troubleshooting Installation

Problem: Git clone fails on network drive

error: cannot lock ref 'refs/remotes/origin/HEAD'
fatal: unable to update refs/remotes/origin/HEAD

Solution: Clone to local drive instead:

# ❌ DON'T: Network drive
Z:\> git clone https://github.com/...

# ✅ DO: Local drive
C:\Users\YourUser\Documents> git clone https://github.com/...

Problem: `vibecode` command not found

Windows:

# Add npm global bin to PATH
setx PATH "%PATH%;%APPDATA%\npm"

# Restart terminal and try again
vibecode --version

Linux/Mac:

# Add to ~/.bashrc or ~/.zshrc
export PATH="$PATH:$(npm config get prefix)/bin"

# Reload shell
source ~/.bashrc

Problem: Permission denied

Windows: Run PowerShell as Administrator

Linux/Mac:

sudo npm install -g .

⚙️ Configuration

First Time Setup

# Start VibeCode — AI Development Terminal
vibecode

# Set your API key
config set apiKey YOUR_API_KEY

# Choose your AI provider
config set provider anthropic  # or openai

# Set your preferred model
config set model claude-3-5-sonnet-20240620

Configuration File

VibeCode — AI Development Terminal stores config in .vibecoderc.json:

{
  "provider": "anthropic",
  "model": "claude-3-5-sonnet-20240620",
  "apiKey": "sk-ant-...",
  "maxTokens": 4096,
  "temperature": 0.7
}

Environment Variables

Alternatively, use environment variables:

# Windows
set ANTHROPIC_API_KEY=sk-ant-...
set OPENAI_API_KEY=sk-...

# Linux/Mac
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

🎯 Commands

Core Commands

Command	Description	Example
`vibe <task>`	Execute AI-powered task	`vibe "refactor this code"`
`help`	Show all commands	`help`
`config`	Manage configuration	`config list`
`switch`	Change AI provider	`switch`
`update`	Update VibeCode from GitHub	`update`

Navigation Commands

Command	Description	Example
`ls`	List files	`ls`
`cd <dir>`	Change directory	`cd src`
`tree`	Show file tree	`tree`
`clear`	Clear terminal	`clear`
`exit`	Exit VibeCode	`exit`

Configuration Commands

# View configuration
config list

# Set API key
config set apiKey YOUR_KEY

# Change provider
config set provider anthropic  # or openai

# View token usage
config usage

# Reset token counter
config reset-usage

# Test connection
config test

� Pro Tips

1. Be Specific

❌ Bad: vibe "improve code" ✅ Good: vibe "refactor auth.ts using async/await and add error handling"

2. Mention Files/Folders

vibe "in folder src/components, create a Button component with TypeScript"
vibe "fix the bug in file auth.ts line 42"

3. Combine Multiple Actions

vibe "refactor, optimize, and add tests to UserService.ts"
vibe "debug this error, fix it, and add logging"

4. Use Context

VibeCode — AI Development Terminal automatically understands:

Your project structure
Installed dependencies
Code style
Recent changes

Just describe what you want!

5. Switch Providers for Different Tasks

switch  # Opens interactive menu

# Claude 3.5 Sonnet → Best for complex refactoring
# GPT-4 → Best for creative solutions
# GPT-4 Turbo → Best for speed

🔄 Updating VibeCode — AI Development Terminal

Automatic Update (Recommended)

Inside VibeCode — AI Development Terminal:

update

The update command automatically:

✅ Checks for new updates from GitHub
✅ Shows you what's changed
✅ Backs up your configuration
✅ Handles local changes safely
✅ Rebuilds and relinks

See UPDATE-GUIDE.md for details.

Manual Update

cd /path/to/Vibecoder-Claude
git pull origin main
npm install
npm run build
npm link

📊 Token Usage & Costs

VibeCode — AI Development Terminal tracks your API usage in real-time:

config usage

Output:

╔════════════════════════════════════════════════════════╗
║  💰 USO DE TOKENS                                      ║
╠════════════════════════════════════════════════════════╣
║  Total de Tokens: 45,230                               ║
║  Custo Total:     $1.2340                              ║
║  Orçamento:       $4.00                                ║
║  Restante:        $2.7660                              ║
║                                                        ║
║  Uso: ████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░      ║
║  30.8% do orçamento utilizado                          ║
╚════════════════════════════════════════════════════════╝

Cost Optimization Tips

Use GPT-4 Turbo for simple tasks (10x cheaper)
Be specific in your prompts (fewer retries)
Set token limits in config
Monitor usage regularly with config usage

🛡️ Security

VibeCode — AI Development Terminal takes security seriously:

✅ What We Do

API keys are masked in all logs and outputs
Local storage only - no cloud sync
No telemetry - your code stays private
Automatic sanitization of sensitive data
User confirmation before executing code changes

🔒 Best Practices

Never commit .vibecoderc.json to Git
Use environment variables for API keys in CI/CD
Rotate keys regularly
Set spending limits on your AI provider dashboard
Review changes before confirming execution

🤝 Contributing

We love contributions! Here's how to help make VibeCode — AI Development Terminal even better:

Quick Start

# Fork and clone to LOCAL drive
cd C:\Users\YourUser\Documents
git clone https://github.com/YOUR_USERNAME/Vibecoder-Claude.git
cd Vibecoder-Claude

# Install dependencies
npm install

# Make your changes
# ...

# Build and test
npm run build
npm link

# Test your changes
vibecode

Contribution Ideas

🐛 Bug fixes - Check Issues
✨ New features - Add new AI providers, commands, or tools
📚 Documentation - Improve README, add tutorials
🎨 UI/UX - Enhance terminal design
🧪 Tests - Add unit and integration tests

Guidelines

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

🐛 Troubleshooting