The MainSequence extension keeps your backend projects close at hand: sign in once, browse every workspace, bootstrap repos locally, and open signed terminals without leaving VS Code.
Installation
Open VS Code and search for MainSequence in the Extensions view (Ctrl/Cmd+Shift+X).
Install MainSequence from MainSequence GmbH.
Click the MainSequence icon in the activity bar and sign in to finish linking your account.
A MainSequence account with access to at least one project.
VS Code 1.89 or newer.
Optional: the MainSequence CLI for parity with terminal tooling (not required inside the extension).
What you can do
Sign in & configure – manage backend URL and local base folder, then sign in right from the “User” view.
Browse projects – the Projects tree lists everything in your org, with a refresh button in the title bar. Items highlighted in your theme’s accent color are already set up locally.
Set up locally – generate deploy keys, clone repositories into your configured base folder, and auto-write .env + tokens.
Open folders & signed terminals – jump into VS Code workspaces or spawn terminals with the correct SSH keys pre-loaded.
Compile env / delete local copies – keep requirements in sync or clean up a project directly from the context menu.
Getting started in VS Code
Click MainSequence → User in the activity bar and provide your backend + base folder if they differ from the defaults.
Sign in. The panel confirms the account you’re using and keeps a Logout button handy.
Switch to MainSequence → Projects and press the refresh icon if needed. Projects that are already on disk show LOCAL plus the accent-colored folder icon.
Right-click a project (or use the ellipsis) for actions like Set Up Project Locally, Open Folder, Open Signed Terminal, or Compile Env.
After running Set Up Project Locally, the tree refreshes automatically so you can immediately open the new workspace.
Commands available in the palette
MainSequence: Sign in – open the login panel.
MainSequence: Refresh Projects – same as the toolbar refresh button.
MainSequence: Set Up Project Locally, Open Folder, Open Signed Terminal, Compile Env, Delete Local Project Folder – available globally or from context menus.
Troubleshooting
If the Projects view says you’re signed out, revisit the User view to log back in.
To reset authentication completely, delete token.json under your OS-specific MainSequence config folder (for example ~/.config/mainsequence).
Logs are available in the VS Code Output panel under MainSequence, plus the Extension Host debug console when running from source.
