Worksynk
Create tasks from code in your editor — pick a project, set a title, choose an assignee. Selection and file path are attached to the task automatically.
Works in VS Code, Cursor, Google Antigravity, and other editors that support VS Code extensions.
Get started
1. Install the extension
From the marketplace (recommended, once published)
- Open Extensions (
Cmd+Shift+X / Ctrl+Shift+X).
- Search Worksynk.
- Click Install.
Or CLI: code --install-extension fulgid.worksynk
From a VSIX file (private / pre-release builds)
- Extensions → ⋯ → Install from VSIX…
- Or CLI (use your editor’s binary, not only
code):
- VS Code:
code --install-extension worksynk-x.y.z.vsix
- Cursor:
cursor --install-extension worksynk-x.y.z.vsix
- Antigravity (Mac):
/Applications/Antigravity.app/Contents/Resources/app/bin/antigravity --install-extension worksynk-x.y.z.vsix
Antigravity (Google)
Antigravity often uses Open VSX by default, so Worksynk may not appear in search until you either install the VSIX or switch the marketplace:
Option A — Install VSIX (easiest)
- Build or download
worksynk-0.2.2.vsix (or latest) from extensions/vscode.
- Antigravity → Extensions → ⋯ → Install from VSIX…
- Or run the
antigravity --install-extension … command above.
Option B — Use the VS Code Marketplace
- Settings → search Marketplace (or Editor marketplace URLs).
- Set:
- Item URL:
https://marketplace.visualstudio.com/items
- Gallery URL:
https://marketplace.visualstudio.com/_apis/public/gallery
- Restart Antigravity.
- Search Worksynk / install
fulgid.worksynk.
2. Create an API key
- Open Worksynk in the browser.
- Go to Settings → API keys.
- Create a key and copy it once (it won’t be shown again).
3. Connect (API key)
After install, Worksynk asks you to Set API key. You can also:
- Click the status bar: Worksynk: Set API key
- Command Palette → Worksynk: Set API Key / Open Setup
In the setup page:
- Confirm API URL and App URL (ask your admin if unsure).
- Paste your API key.
- Click Connect (pick a workspace if you have several).
Your key is stored only on this machine (editor secret storage), not in project files.
You’re ready when the status bar shows your workspace name.
Create a task from code
Fast path
- Select code (or just open a file).
- Click status bar + Task, or right-click → Worksynk: Create Task, or use the CodeLens above the line.
- Confirm project (optional if you set a default) and title (smart-filled).
- Confirm assignee every time (or Unassigned), then create — label IDE.
Also available
- Link Code to Existing Task — attach the selection as a code comment on a recent/assigned task.
- Type / assignee pickers can be turned back on under Settings → Worksynk.
Tasks get the IDE label by default. Descriptions use a real HTML code block (code view in the app), plus summary, path, and git branch when available.
View and act on tasks without leaving the editor
- Worksynk: View Task… opens a panel beside your code: description, comments (post one right there), status, priority, and assignee — all editable.
- Click any task in the Assigned to me sidebar to open the same panel instead of jumping to the browser.
- Any task code found in an open file (e.g.
PROJ-123) is underlined — hover it for a status card, click Open task to jump straight to the panel. Turn off with worksynk.taskCodeDecorations.
- Worksynk: Change Task Status… — quick status change without opening the panel.
Time tracking
- Worksynk: Start Timer… — pick a task (from your assigned/recent list, or any live search) and start its timer.
- Worksynk: Stop Timer — stops whatever's running, no picker needed.
- While a timer runs, the status bar shows
⏱ CODE 00:12:34 — click it to stop. It also picks up timers started elsewhere (the web app, another device) within 30 seconds.
Commands
| Command |
Use it to |
| Worksynk: Set API Key / Open Setup |
Setup page — API URL, app URL, API key |
| Worksynk: Create Task |
Selection if any, else whole file (fastest) |
| Worksynk: Create Task from Selection |
New task from highlighted code |
| Worksynk: Create Task from File |
New task linked to the current file |
| Worksynk: Link Code to Existing Task |
Attach code as a comment on a task |
| Worksynk: View Task… |
Open the read/edit panel for any task |
| Worksynk: Change Task Status… |
Quick status change |
| Worksynk: Start Timer… |
Pick a task and start tracking time |
| Worksynk: Stop Timer |
Stop whatever timer is running |
| Worksynk: Set Default Project |
Remember project |
| Worksynk: Switch Workspace |
Change workspace |
| Worksynk: Refresh My Tasks |
Reload the sidebar list |
Settings
Open Settings and search for worksynk:
| Setting |
What it is |
| API URL |
Default https://api.worksynk.app/api/v1 (local: https://worksynk.test/api/v1) |
| App URL |
Default https://app.worksynk.app (local: https://worksynk.test) |
| Default project ID |
Optional project to preselect when creating tasks |
| Skip type prompt |
On — use smart type (bug/feature/task) |
| Default assignee me |
Off — always show assignee picker (turn on to auto-assign yourself) |
| Auto remember project |
On — last project becomes default |
| Use default project silently |
Off — turn on to skip project picker |
| Task code decorations |
On — underline task codes in code with a hover status card |
Your API key is stored in the editor’s Secret Storage, not in settings files.
Tips
- Use the Worksynk icon in the activity bar to see tasks assigned to you.
- Private projects only appear if you have access; assignees are people on that project.
- If sign-in fails, check API URL and that your account has an active workspace (not a pending join request).
Support
Need help? Contact your Worksynk admin, or support for your workspace.
