DevHours.fun VS Code Extension

Track your coding hours automatically and compete with developers worldwide!

🎯 Features

• ⏱️ Automatic Time Tracking - Tracks your active coding time per project and language
• 🎯 Smart Detection - Pauses automatically after 2 minutes of inactivity
• 💾 Offline Support - Stores data locally and syncs when online
• 📊 Real-time Stats - View your daily coding time in the status bar
• 🔒 Privacy First - Only tracks metadata (project, language, duration) - never your code

📦 Installation

From VS Code Marketplace

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

From VSIX File

code --install-extension devhours-fun-0.1.0.vsix

🚀 Quick Start

1. Install Extension - Get it from VS Code Marketplace
2. Connect Account
   • Run command: DevHours: Connect Account (Cmd/Ctrl + Shift + P)
   • Sign in at devhours.fun
   • Copy your auth token
   • Paste it in VS Code
3. Start Coding - That's it! Your time is automatically tracked

🎮 Commands

Open Command Palette (Cmd/Ctrl + Shift + P) and type:

• DevHours: Connect Account - Connect your DevHours.fun account
• DevHours: Sync Now - Manually sync your data
• DevHours: View Logs - View local tracking logs
• DevHours: Disconnect Account - Disconnect your account

⚙️ Configuration

Access settings in VS Code Preferences → Extensions → DevHours

Available Settings

Example Configuration

{
  "devhours.inactivityThreshold": 180,
  "devhours.syncInterval": 300,
  "devhours.apiEndpoint": "https://devhours.fun/api"
}

📊 What Gets Tracked?

For each coding session, we track:

• Project name - From your workspace folder name
• Language - The programming language you're using
• Duration - Time spent actively coding (in minutes)
• Timestamp - When the coding session occurred

We NEVER track:

• Your actual code content
• File names or paths
• Keystrokes or specific edits
• Personal information

🔧 How It Works

1. Detection - Extension detects when you're actively coding (typing, editing files)
2. Tracking - Counts active coding time, automatically pausing after 2 minutes of inactivity
3. Storage - Saves data locally in case you're offline
4. Sync - Syncs to DevHours.fun every 10 minutes or when VS Code closes
5. Display - Shows your daily total in the status bar

🚨 Troubleshooting

Extension Not Tracking

1. Make sure you're connected (check status bar)
2. Try running DevHours: Sync Now
3. Check VS Code output panel for errors

Sync Failing

1. Check your internet connection
2. Verify your auth token is still valid
3. Try disconnecting and reconnecting your account

Status Bar Not Showing

1. Restart VS Code
2. Make sure the extension is enabled
3. Check for VS Code updates

🔐 Privacy & Security

• No Code Collection - We never see your actual code
• Encrypted Transit - All data is sent over HTTPS
• Local First - Data is stored locally and only synced with your permission
• Open Source - View our code on GitHub
• Token Security - Auth tokens are stored in VS Code's secure storage (SecretStorage)

🏗️ Development

Setup

# Clone repository
git clone https://github.com/yourusername/devhours.fun-vscode

# Install dependencies
cd devhours.fun-vscode
npm install

# Compile TypeScript
npm run compile

# Watch for changes
npm run watch

Testing

Press F5 in VS Code to launch Extension Development Host.

Building

# Install VSCE
npm install -g @vscode/vsce

# Package extension
vsce package

# This creates devhours-fun-0.1.0.vsix

📁 Project Structure

devhours.fun-vscode/
├── src/
│   ├── extension.ts    # Main extension entry point
│   ├── tracker.ts      # Activity tracking logic
│   ├── sync.ts         # Supabase sync functionality
│   ├── auth.ts         # Authentication handling
│   └── types.ts        # TypeScript type definitions
├── package.json        # Extension manifest
└── tsconfig.json       # TypeScript configuration

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📄 License

MIT License - See LICENSE file for details

🔗 Links

• Web App
• GitHub Repository
• Report Issues
• Documentation

💬 Support

Need help?

• Check the FAQ
• Open an issue
• Join our Discord

Made with ❤️ by developers, for developers.