A Visual Studio Code extension to help freelancers track time and calculate project costs based on hourly rates based on monthly salary input.
Features
Tracks total hours worked on a project.
Calculates project cost based on hourly rate.
Supports custom hourly rate calculations from monthly salary.
Displays a status bar timer and a detailed cost summary panel.
Saves work session data automatically, so hours and rates are persistent.
Installation
Open Visual Studio Code.
Go to the Extensions view by clicking on the Extensions icon in the Activity Bar on the side of the window or by pressing Ctrl+Shift+X.
In the search bar, type "Ahsebly - أحسبلى" (replace with the actual name of your extension on the Marketplace if it's different).
Click Install on the extension from the Marketplace results.
Once installed, the extension will be activated automatically.
Alternatively, you can install directly from the Visual Studio Code Marketplace by searching for Ahsebly - أحسبلى (replace with the actual name of your extension).
Usage
Open a project in VS Code.
If it's your first time using the extension, you'll be prompted to specify if it's a freelance project.
Select Yes to enable time tracking.
Select No if it's not a freelance project. You can change this setting later.
If you select Yes, you’ll be prompted to enter your monthly salary. The extension calculates the hourly rate using this formula:
The status bar will display the total time worked. Click on it to open a detailed view with:
Total hours worked
Hourly rate
Total cost
Commands
Show Total Cost: Displays the project’s total hours, hourly rate, and total cost in an HTML view.
Data Persistence
The extension saves the following data between sessions:
Total hours
Hourly rate
Freelancer status
The data is associated with each project and stored in VS Code’s global state.
Customization
Hourly Rate: Can be modified by re-entering the monthly salary when prompted.
Freelancer Status: Set when starting the project.
Example Formula
The hourly rate is calculated based on a monthly salary input, using this formula:
(Monthly Salary ÷ 22 working days ÷ 8 hours per day) × 1.5 (50% FreeLance rate) × 1.3 (30% risk factor and adjustments)
