Connects to your Clockify and ClickUp, resolves BC customer codes and Progressus job/task numbers, and displays a ready-to-use reference table for filling in BC/Progressus time registration manually.
npm install
Double-click start.bat, or run:
node server.js
Then open http://localhost:3000.
On first launch the tool shows a setup screen. Paste your Clockify API key and click Connect — it will automatically look up your workspace and user ID and save config/settings.json for you.
Where to find your API key: Clockify → Profile icon → Profile Settings → scroll to API → Generate API key.
Project names must include the BC customer number in parentheses:
Abileer (DWDK-P00094)
Metro - Phase 2 (DWDK-P00042)
The tool parses anything matching (DWDK-Pxxxxx) from the project name automatically. Projects without this pattern show as red rows.
- Open the tool — it defaults to yesterday's date
- Click Fetch
- Use the table as a reference while filling in BC/Progressus:
| Row colour | Meaning | Action |
|---|---|---|
| Green | All codes resolved | Copy BC Customer, Job No, Task No, Work Type directly into BC |
| Amber | BC customer found, Progressus codes missing | Click + Add Progressus mapping, fill in once — remembered for all future days |
| Red | No (DWDK-Pxxxxx) in the Clockify project name |
Edit the project name in Clockify |
When a PM gives you Job No and Task No before you have logged any time, go to the Mappings tab → + New Mapping → select the Clockify project from the dropdown → fill in the codes → Save.
Share the folder or git repo. Each person:
- Runs
npm install - Opens the tool — the setup screen walks them through connecting their own Clockify account
config/settings.json is personal (git-ignored). config/mappings.json is shared and can be committed to git so the whole team uses the same Progressus mappings.