CollabOps

VS Code Extension

Manage issues and change requests from inside the editor

The CollabOps extension for VS Code lets you browse and manage issues, change requests, projects, and documents without leaving the editor.

It also works in Cursor, which is based on VS Code.

1. Installation

Install from the Marketplace

The extension page is at marketplace.visualstudio.com/items?itemName=collabops.collabops.

Select the Extensions icon in the activity bar.

Type CollabOps in the search box.

Select CollabOps in the results and click Install.

Searching for CollabOps in the Extensions view

Figure 1 — Marketplace search

When installation finishes, the CollabOps icon appears in the activity bar.

Install from the command line

code --install-extension collabops.collabops

For Cursor:

cursor --install-extension collabops.collabops

VS Code 1.90 or later is required.

2. Signing in

You sign in from the extension itself. No prior setup is required.

Select the CollabOps icon in the activity bar.

Select Sign in.

Sidebar before signing in

Figure 1-1 — Sign-in prompt

Enter the server address.

Server address prompt

Figure 1-2 — Server address

Enter your email and password.

Email prompt

Figure 1-3 — Account details

Select a workspace.

Workspace picker

Figure 1-4 — Selecting a workspace
FieldDescription
Server addressUse the default for SaaS. For on-premises installations, enter your server address.
EmailYour CollabOps account email
PasswordYour CollabOps account password
WorkspaceSelected automatically if you have access to only one workspace.

The server address, email, and workspace are saved, so you do not need to enter them again. If your session expires, only the password is requested.

3. Interface

Selecting the CollabOps icon in the activity bar shows the following lists in the sidebar.

Sidebar with the Status view grouped by role

Figure 2 — Sidebar and Status view
ListContents
StatusChange requests you created, change requests awaiting your review, and issues assigned to you, grouped by role.
My Change RequestsChange requests you created
My IssuesIssues assigned to you
Workspace IssuesAll issues in the workspace
ProjectsProjects in the workspace
RepositoriesRepositories in the workspace
DocsDocuments in the workspace
Workflow RunsRecent pipeline runs
LabelsWorkspace labels
Status GroupsIssue status group settings

Item status is indicated by icons. Issues are shown by progress stage; change requests are shown by merged, closed, draft, or conflicting state.

4. Browsing

Details

Selecting an item opens its details in Markdown. Change request details include the description, linked issues, CI results, and activity history.

Issue detail view

Figure 3 — Issue detail

Change request detail view

Figure 2-1 — Change request detail: description, linked issues, checks (CI), and activity on one page

To open an item in the browser, select the link icon on the right of the item.

Search issues, change requests, documents, projects, and repositories at once.

Unified search results

Figure 5 — Unified search
OSShortcut
macOSCmd + Alt + P
Windows and LinuxCtrl + Alt + P

You can also run CollabOps: Search from the command palette.

5. Editing

Right-click an item and select Edit to open an edit buffer.

Edit buffer

Figure 4 — Edit buffer
---
title: Improve the sign-in screen
status: in_progress
priority: high
end_date: 2026-08-20
---

Write the body in Markdown.

- Lists
- Tables
- Code blocks

Edit the title, status, priority, and due date in the upper section, and the body below. Saving applies only the fields you changed.

6. Actions

Right-clicking an item shows the actions available for that item type.

TargetAvailable actions
IssueCreate, close, reopen, comment, link issues, sub-issues, link documents
Change requestCreate, review, merge, toggle draft, comment, link issues, link documents
DocumentCreate, edit body, restore version, comment
ProjectCreate, manage members, teams, and milestones
Workflow runCancel, re-run, view logs

Every action that modifies data requires input or confirmation.

7. Git integration

The following operations are available from the editor.

Create a topic branch from an issue

Check out the source branch of a change request

View the diff of a change request

Update a change request branch with its target branch

Clone a repository

Git commands are sent to the integrated terminal. Commands that modify the working tree are typed into the terminal but not executed, so you decide whether to run them.

8. Commands

Type CollabOps in the command palette to see the available commands.

CommandDescription
CollabOps: Sign inConnect to a server and authenticate
CollabOps: Sign outDelete the saved session
CollabOps: Select workspaceSwitch workspace
CollabOps: Change serverChange the server address and sign in again
CollabOps: SearchUnified search
CollabOps: RefreshRefresh all lists

9. Notes

Whitespace when editing body text

The server removes leading and trailing whitespace from text when saving, so a space adjacent to bold, code, or link formatting may be dropped. The same behavior applies in the web editor.

Images

Images in the body are shown as identifiers and cannot be previewed in the editor. Attachments are preserved when you edit and save.

Not supported

Permanent deletion — use the web application.

Assigning users and labels

Remote development

In Remote SSH and Dev Container environments the extension runs on the remote host, so you must sign in separately in that environment.

10. Troubleshooting

SymptomWhat to check
Lists show an errorThe session has likely expired. Run CollabOps: Sign in again.
Cannot connect in an on-premises environmentVerify the server address. If you use a private certificate, check the http.systemCertificates setting in VS Code.
Lists are emptyVerify that the correct workspace is selected. Use CollabOps: Select workspace to switch.

Table of Contents