BashForge Extension

🚀 Quick Start

Installation

From VS Code Marketplace (Recommended)

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "BashForge"
4. Click Install

Manual Installation

1. Download the latest .vsix file from GitHub
2. Open VS Code
3. Go to Extensions view (Ctrl+Shift+X / Cmd+Shift+X)
4. Click the ... menu → Install from VSIX...
5. Select the downloaded .vsix file

Setup & Configuration

1. Get Your Private Key

   • Visit BashForge
   • Sign up or log in to your account
   • Go to Dashboard → Private Key
   • Copy your private Private Key

2. Configure Extension

   • Open VS Code Settings (Ctrl+, / Cmd+,)
   • Search for "BashForge"
   • Paste your Private Key in the BashForge: Private Key field

3. Start Coding!

   • The extension automatically starts tracking when you begin coding
   • View your progress on the BashForge Dashboard

⚙️ Extension Settings

bashForge.inputPrivateKey

• Description: Quickly set or update your BashForge Private Key via the Command Palette.
• How to use: Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P), search for BashForge: Enter Private Key, and enter your key when prompted.
• Purpose: Provides a convenient way to configure your Private Key without navigating through settings.

🎯 Supported Languages

The extension automatically detects and tracks the languages

📁 How It Works

1. File Monitoring: Tracks active file changes and editor focus
2. Language Detection: Identifies programming language from file extensions
3. Data Collection: Securely collects time spent and language usage
4. Secure Sync: Encrypts and sends data to BashForge servers
5. Real-time Updates: Updates your profile and leaderboard position

🛠️ Development

Prerequisites

• Node.js 18+
• VS Code Extension Development Environment
• TypeScript knowledge

🤝 Contributing

We welcome contributions!

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📋 Requirements

• VS Code: Version 1.74.0 or higher
• Node.js: Version 16+ (for development)
• Internet: Required for data synchronization
• BashForge Account: Free account at bashforge.vercel.app