CodeTempo VS Code Extension

A VS Code extension for time tracking and productivity monitoring that integrates with the CodeTempo platform.

Features

• Real-time time tracking while coding
• Project-based time organization
• Privacy controls for sensitive data
• Team collaboration and reporting
• Seamless integration with CodeTempo web platform

Installation

From VS Code Marketplace (Coming Soon)

Once published, you can install the extension directly from the VS Code Marketplace:

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

Manual Installation

For development or testing purposes:

1. Download the latest .vsix file from releases
2. Open VS Code
3. Go to Extensions (Ctrl+Shift+X)
4. Click the "..." menu and select "Install from VSIX..."
5. Select the downloaded .vsix file

Publishing Guide

This section is for maintainers who need to publish the extension to the VS Code Marketplace.

Prerequisites

Before publishing, ensure you have:

• A Microsoft account
• Access to Azure DevOps
• Publisher account on VS Code Marketplace

Step 1: Create a Visual Studio Marketplace Publisher Account

1. Go to: https://marketplace.visualstudio.com/manage/publishers/
2. Sign in with your Microsoft account (or create one if needed)
3. Create a publisher with the ID AcornTechnologySolutions (this must match what's in package.json)

Step 2: Generate a Personal Access Token (PAT)

To publish extensions, you need a Personal Access Token with proper permissions:

1. Go to: https://dev.azure.com/

2. Sign in with the same Microsoft account used for the marketplace

3. Click on your profile picture → Personal access tokens

4. Click + New Token

5. Configure the token:

   • Name: "VS Code Extension Publishing" (or similar)
   • Organization: Select your organization
   • Expiration: Choose your preferred duration
   • Scopes: Select Custom defined and check:
     • Marketplace → Manage (this is crucial for publishing)

6. Click Create

7. Important: Copy the token immediately (you won't be able to see it again)

Step 3: Publishing the Extension

Option A: Direct Publishing

# Navigate to the plugin directory
cd /Users/sannminwin/Sites/code-tempo/vscode_plugin

# Publish the extension
npx vsce publish

When prompted, paste your Personal Access Token.

Option B: Login First (Recommended)

# Navigate to the plugin directory
cd /Users/sannminwin/Sites/code-tempo/vscode_plugin

# Login with your publisher account
npx vsce login AcornTechnologySolutions

# Then publish
npx vsce publish

Step 4: Verify Publication

After successful publication, verify your extension is live:

1. Visit: https://marketplace.visualstudio.com/items?itemName=AcornTechnologySolutions.codetempo-vscode
2. Check that the extension appears in VS Code marketplace search
3. Test installation from marketplace

Development Commands

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Run tests
npm test

# Package extension (creates .vsix file)
npx vsce package

# List files that will be included in package
npx vsce ls --tree

Important Notes

• Publisher ID: The publisher ID AcornTechnologySolutions in package.json must match the publisher you create on the marketplace
• Security: Keep your Personal Access Token secure and don't share it
• Permissions: The PAT needs Marketplace → Manage permissions to publish extensions
• License: Ensure the LICENSE file is present (required for marketplace publishing)

Troubleshooting

Common Issues

1. "Extension not found" error: The extension hasn't been published to the marketplace yet
2. "Missing LICENSE file": Add a LICENSE file to the root directory
3. "Invalid publisher": Ensure the publisher ID in package.json matches your marketplace publisher
4. "Authentication failed": Verify your Personal Access Token has correct permissions

Getting Help

If you encounter issues during publishing:

1. Check the VS Code Extension Publishing Guide
2. Verify your publisher account at https://marketplace.visualstudio.com/manage/publishers/
3. Ensure your PAT has the correct scopes at https://dev.azure.com/

License

MIT License - see LICENSE file for details.

Contributing

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

Support

For support and questions:

• Create an issue in the GitHub repository
• Contact the CodeTempo team
• Check the documentation at the main CodeTempo platform