Pulse Tracker
A beautiful and efficient task tracking extension for VS Code that integrates with your Pulse timelog system. Track your development tasks with real-time analytics and seamlessly transfer them to your Pulse backend.
Features
- 🔐 Secure Authentication: Login with your Pulse credentials for secure task tracking
- ⏱️ Real-time Task Tracking: Start and stop tasks with a beautiful timer display
- 📊 Project Integration: Link tasks to specific projects from your Pulse system
- 🎨 Beautiful UI: Modern, responsive design with smooth animations
- 📱 Status Bar Integration: See active tasks directly in VS Code's status bar
- 🔄 Pulse Integration: Transfer completed tasks to your Pulse timelog system
- 📋 Task Management: View and manage all your tracked tasks
- 👤 User Profile: See your login status and user information
- ⌨️ Keyboard Shortcuts: Quick access with customizable shortcuts
Quick Start
- Install the extension from the VS Code Marketplace
- Configure your Pulse API URL in VS Code settings
- Login using the command palette (
Ctrl+Shift+P
→ "Pulse Tracker: Login")
- Start tracking tasks with
Ctrl+Shift+Alt+T
- Transfer to Pulse when ready
Installation
From VS Code Marketplace
- Open VS Code
- Go to Extensions (Ctrl+Shift+X)
- Search for "Pulse Tracker"
- Click Install
Manual Installation
- Download the .vsix file from the releases
- Install in VS Code:
- Open VS Code
- Go to Extensions (Ctrl+Shift+X)
- Click the "..." menu and select "Install from VSIX..."
- Select the downloaded .vsix file
Configuration
Pulse API Settings
Open VS Code Settings (Ctrl+,)
Search for "Pulse Tracker"
Configure the following settings:
- API URL: Your Pulse application URL (e.g.,
https://your-pulse-app.com
)
Note: Authentication is handled through login - no need to configure API tokens manually!
Usage
Commands
The extension provides the following commands (accessible via Command Palette - Ctrl+Shift+P):
- Pulse Tracker: Login - Login with your Pulse credentials
- Pulse Tracker: Logout - Logout from the extension
- Pulse Tracker: Start Task - Start tracking a new task (requires login)
- Pulse Tracker: Stop Task - Stop the currently running task (requires login)
- Pulse Tracker: Show Task List - Open the task list view (requires login)
- Pulse Tracker: Transfer Tasks to Pulse - Transfer completed tasks to Pulse (requires login)
Quick Start Guide
Login first:
- Press
Ctrl+Shift+P
and type "Pulse Tracker: Login"
- Enter your Pulse email and password
- You'll see your name in the status bar when logged in
Start a task:
- Press
Ctrl+Shift+P
and type "Pulse Tracker: Start Task"
- Select a project from the dropdown
- Enter a task description
- The task will start tracking immediately
Monitor progress:
- The active task appears in the status bar with a timer
- Click the status bar item to open the task list
Stop a task:
- Press
Ctrl+Shift+P
and type "Pulse Tracker: Stop Task"
- The task will be added to your completed tasks list
Transfer to Pulse:
- Open the task list view
- Click "Transfer to Pulse" to send completed tasks to your Pulse system
Logout when done:
- Press
Ctrl+Shift+P
and type "Pulse Tracker: Logout"
- This will clear your session and stop any active tasks
Status Bar
The status bar shows different information based on your login status:
When logged in:
- Shows your name when no task is active
- Shows task description and elapsed time when a task is running
- Click to open the task list
When not logged in:
- Shows "Login Required" with a sign-in icon
- Click to login to the extension
Status bar automatically updates every second when tracking tasks
Keyboard Shortcuts
Ctrl+Shift+Alt+T
- Start a new task (when logged in and no task running)
Ctrl+Shift+Alt+S
- Stop current task (when logged in and task running)
Troubleshooting
Common Issues
"Command not found" error:
- Restart VS Code after installation
- Check if the extension is properly installed
- Try reloading the window (Ctrl+Shift+P → "Developer: Reload Window")
Login fails:
- Check your Pulse API URL in settings
- Ensure your Pulse application is accessible
- Verify your credentials are correct
No projects available:
- Check your Pulse API URL configuration
- Ensure your Pulse application has projects configured
- Contact your system administrator if issues persist
Transfer fails:
- Check your Pulse API URL in settings
- Ensure your Pulse endpoint is accessible
- Verify network connectivity
Debug Mode
To enable debug logging:
- Open the Extension Development Host
- Open Developer Console (Help > Toggle Developer Tools)
- Look for "Pulse Tracker" messages
Development
Building from Source
# Clone the repository
git clone <repository-url>
cd vscode-extension
# Install dependencies
npm install
# Compile TypeScript
npm run compile
# Package for distribution
npm run package
Project Structure
vscode-extension/
├── src/
│ └── extension.ts # Main extension logic
├── resources/
│ ├── icon.svg # Extension icon
│ └── icon.png # Fallback icon
├── package.json # Extension manifest
├── tsconfig.json # TypeScript configuration
└── README.md # This file
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
License
This extension is licensed under the MIT License.
Support
For issues and feature requests, please create an issue in the repository.
Privacy
This extension connects to your Pulse application for authentication and task management. No data is stored locally beyond session information and completed tasks until they are transferred to your Pulse system.