Skip to content
FeaturesDownloadWindowsmacOSLinuxDocumentation
Documentation

VisionFall Studio Handbook

How to share a studio, set up a language in one click, get the most from terminal suggestions, and everything else the studio does.

Version 1.0 Launching 1 October 2026 Windows · macOS · Linux

01Overview#

VisionFall Studio is a development environment for Windows, macOS and Linux, built by VisionFall Pvt. Ltd. It is designed around three things that usually cost developers the most time:

  • Getting someone into your code. Share your whole studio with a nine-digit ID and decide exactly what the other person may do — Sharing a studio.
  • Getting a language onto your machine. Install a complete toolchain in one click, verified afterwards — Setting up languages.
  • Remembering the exact command. The terminal suggests commands, flags, branches and paths as you type — Terminal suggestions.

Around them sits a complete editor: completion that reads your project, integrated debugging, native Git, six themes and six keymaps, and a bridge that lets Windows and Linux share one workspace.

02Launch & downloads#

VisionFall Studio 1.0 launches on 1 October 2026. The setup files below unlock on their own at that moment — there is no need to reload.

macOS

macOS 13 Ventura or later

Apple Silicon.dmgMacs with an M1, M2, M3 or M4 chip 1 OctIntel.dmgMacs with an Intel processor 1 Oct
macOS details and requirements

Linux

64-bit · glibc 2.31 or newer

Debian · Ubuntu.debDebian, Ubuntu, Linux Mint, Pop!_OS and Kali 1 OctFedora · RHEL.rpmFedora, RHEL, Rocky, AlmaLinux and openSUSE 1 Oct
Linux details and requirements

03System requirements#

Version
Windows 10 or Windows 11
Architecture
64-bit (x64)
Memory
8 GB minimum, 16 GB recommended
Disk
About 2 GB, plus the languages you install
WSL2 bridge
Optional — WSL2, with WSLg on Windows 11

On every platform#

Memory
8 GB minimum, 16 GB recommended
Disk
About 2 GB, plus the languages you install
Display
1280 × 800 or larger
Code sharing
An internet connection on both sides

04Sharing a studio#

Code sharing lives in the Remote Assist view. One person shares their studio; the other connects to it from their own copy of VisionFall Studio. Nobody needs an account, and nothing has to be pushed anywhere first.

Share your studio#

  1. Open the folder you want help with. A session shares the workspace folders, so a window with no folder open cannot share.
  2. In Remote Assist, choose Share This Studio.
  3. Give the other person the Studio ID — nine digits, such as 428 615 903 — and the session password. Copy ID & password puts both on the clipboard at once.

Connect to someone else's studio#

  1. In Remote Assist, choose Connect to a Studio…
  2. Enter the Studio ID the other person read out.
  3. Enter the session password shown on their screen.

Choosing what they can do#

When someone connects, the host sees who is asking, which version of the studio they run and on which platform, and picks one of three levels — or declines.

LevelWhat the other person can do
View onlyRead the shared folders. No changes, no terminal.
EditingRead and change files, and open files on your screen.
Full controlEverything above, plus a terminal on your machine.

During a session#

  • Chat — message the other side without leaving the studio.
  • Follow Their Cursor — your view moves with theirs as they work.
  • Shared Terminal — available when the session has full control.
  • Add to Workspace — their shared folders appear in your Explorer beside your own, and are removed again when the session ends.
  • Activity — a running log of every file opened, edited, created or renamed during the session.

If the host has unsaved changes in a file, the studio asks the guest to wait for a save before editing it, so nobody overwrites anybody.

Ending a session#

  • Disconnect leaves a session you joined.
  • Stop sharing ends your session and disconnects everyone in it.
  • New password issues a fresh session password. People already connected keep their access.

Settings#

SettingEffect
visionfall.remoteAssist.enabledTurns code sharing on or off entirely. On by default.
visionfall.remoteAssist.displayNameThe name the other side sees. Defaults to the name of your open folder.
visionfall.remoteAssist.defaultPermissionsThe level offered first when someone connects — viewOnly, edit (default) or fullControl.
visionfall.remoteAssist.requireApprovalAsk before letting anyone in, even with the password. On by default.
visionfall.remoteAssist.trustedStudiosNames that may connect without approval each time, provided they have the password.
visionfall.remoteAssist.showRemoteCursorsShow the other person's cursor and selection. On by default.
visionfall.remoteAssist.maxFileSizeMBLargest file a session will transfer. 32 MB by default.
visionfall.remoteAssist.relayUrlThe relay that pairs two studios. Leave empty to use the one that ships with the studio.
Session contents are encrypted. A studio stops accepting connections for a while after repeated wrong passwords, and throttles repeated attempts from one network.

05Setting up languages#

Languages are installed from the Development Environments view. Pick one, press Install, and the studio fetches the toolchain, configures it and adds the matching editor extensions.

Available in one click#

Node.jsPythonJavaGo (Golang)RustC / C++.NET & C#Flutter & DartPHPRuby

Need something that is not on the list? Search from the same view — the studio looks for a matching environment in the extension marketplace.

What an install does#

Progress is shown as “Step 2 of 6”, with each stage named as it runs:

StageWhat happens
PrepareChecks what is already installed and works out what is needed.
DownloadFetches the toolchain for your operating system.
ExtractUnpacks it into place.
ConfigureWires the toolchain into your PATH so terminals can find it.
ExtensionsAdds the editor extensions for that language.
VerifyLooks for the toolchain again to confirm the install really worked.

Why verification matters#

An installer can finish without error and still leave nothing usable behind. The studio only reports success when its second look actually finds the toolchain — otherwise it says so, with notes on anything that needs a manual step.

Some installs change your PATH. When that needs a fresh terminal or a restart of the studio, you are told at the end of the install.

Removing a language#

The same view removes a toolchain, and verifies that too — a removal only counts as done once the toolchain can no longer be found.

06Terminal suggestions#

As you type in the integrated terminal, the studio suggests commands, flags, git branches, file paths and earlier commands — inline as faint ghost text, and in a list with a short description of each.

Using suggestions#

KeyEffect
TabAccept the highlighted suggestion.
↑ ↓Move through the list.
EscDismiss the list and keep typing.
↑On the first suggestion, before moving, walks back through command history.

Supported shells#

Bash, Zsh, Fish and PowerShell on every platform, and Git Bash on Windows — including shells running inside WSL2. Suggestions rely on the terminal's shell integration, which is on by default.

Settings#

SettingEffect
terminal.integrated.suggest.enabledTurns terminal suggestions on or off.
terminal.integrated.suggest.quickSuggestionsWhether suggestions appear automatically while you type.
terminal.integrated.suggest.suggestOnTriggerCharactersWhether typing a trigger character, such as a dash, opens suggestions.
terminal.integrated.suggest.inlineSuggestionWhether the shell's own inline suggestion is detected, and how it ranks.
terminal.integrated.suggest.runOnEnterWhether accepting with Enter (rather than Tab) also runs the command.
terminal.integrated.suggest.cdPathOffers folders on your $CDPATH from any directory.
terminal.integrated.suggest.upArrowNavigatesHistoryWhether the up arrow reaches history from the first suggestion.
terminal.integrated.suggest.showStatusBarShows a small status bar under the suggestion list.

07Themes & keymaps#

You choose a theme and a keyboard layout the first time the studio opens, and can change either at any time from the Command Palette — no restart needed.

Themes

Dark 2026, Light 2026, Solarized Dark, Solarized Light, Dark High Contrast and Light High Contrast.

Keymaps

VisionFall Studio (default), Sublime Text, IntelliJ / JetBrains, Vim, Eclipse and Notepad++.

Code completion#

Suggestions in the editor are ranked by what the surrounding code actually does, with the signature, a short preview and the import added for you when you accept.

08Launch modes#

Desktop

The normal way to run the studio — a native window on Windows, macOS and Linux, opened from the Start menu, Launchpad or your application list.

In a browser

Run the studio headlessly on a machine and open it from any browser — handy on a server, or inside WSL2 without a display.

Running it in a browser#

Start the studio server with visionfall-studio serve-web, then open http://localhost:8000.

OptionEffect
--port <n>Serve on a port other than 8000.
--host <address>Listen on another address — 0.0.0.0 makes it reachable across your network.
--connection-token <token>Require a token in the URL before anyone can open the studio.

Network parameters#

For the documented bridged setup, these defaults are assumed:

Local IP
172.17.190.230
Subnet mask
255.255.255.128
Gateway
172.17.190.129
DNS
172.17.190.129, 8.8.8.8

09WSL2 bridge#

On Windows, the studio can run its core inside a WSL2 Linux distribution and show it on the Windows side — as a native window through WSLg, or in the browser. Everything it runs then follows Linux conventions, whichever side you started from.

VisionFall Studio WSL2 bridge architectureThe Windows host — browser, WSLg or X server, and a terminal — connects through the VisionFall bridge, which enforces LF line endings, Bash shells and /mnt path translation, into the WSL2 Linux guest running the studio core, the Node 22 and Electron runtime, the language toolchains, and the studio web server on port 8000.WINDOWS HOSTBRIDGEWSL2 LINUX GUESTBrowserlocalhost:8000WSLg / X serverVcXsrv · X410Terminalvisionfall-studioLFbash/mntutf-8VisionFall Studio coresrc/ · Monaco · TypeScriptNode 22 · Electronnode-pty · kerberos · keymapLanguage toolchainsNode · Python · Go · RustStudio servervisionfall-studio-server
The bridge is not a proxy — it is a set of enforced conventions. Whatever starts on the Windows side is normalised before it reaches the Linux side.

Mixed Windows and Linux work tends to fail in small, expensive ways: a script saved with CRLF endings that will not run, a path that exists on one side only, a shell that is not the one the command expected. The bridge normalises line endings, shell and paths before anything reaches Linux.

10Troubleshooting#

What you seeWhyWhat to do
“A Studio ID is nine digits”The ID was mistyped or cut short.Enter all nine digits, for example 428 615 903.
“That Studio is not sharing right now”The host has not started sharing, or has stopped.Ask them to choose Share This Studio again and read out the ID.
“Open the folder you need help with before sharing”The window has no folder open, so there is nothing to share.Open the project folder, then share.
“Too many connection attempts from this network”Several attempts arrived in a short time.Wait a minute, then try again.
The other studio has stopped accepting connectionsRepeated wrong passwords locked it temporarily.Wait, then ask the host for the current password — they may have issued a new one.
A language installed, but the terminal cannot find itThe terminal was opened before PATH changed.Open a new terminal, or restart the studio if the install asked you to.
No suggestions appear in the terminalSuggestions are off, or the shell is not integrated.Check terminal.integrated.suggest.enabled, and use Bash, Zsh, Fish or PowerShell.
Scripts fail on WSL2 with “bad interpreter”The file was saved with CRLF line endings.Turn on the WSL2 bridge, which enforces LF endings, and save the file again.
localhost:8000 does not loadThe server is not running, or the port is in use.Start visionfall-studio serve-web, or choose another --port.
The window is blank or draws incorrectlyA graphics driver the renderer cannot use.Start once with --disable-gpu to confirm, then update the driver.

11Support#

VisionFall Studio is built and supported directly by VisionFall Pvt. Ltd. Every message is read and answered by a person.

Technical support

Include your platform, the studio version and what you did.

Email support

Licensing

Seats, site licences and deployment across a team.

Email licensing

Training

Courses, lab setup and instructor-led sessions.

Email training

Licence#

VisionFall Studio is proprietary software. © 2026 VisionFall Pvt. Ltd. All rights reserved. Use is governed by the licence agreement shown during installation.

12Reference#

Command line#

CommandEffect
visionfall-studio .Open the current folder.
visionfall-studio --new-windowOpen a new window instead of reusing one.
visionfall-studio serve-webRun the studio for a browser, on port 8000.
visionfall-studio --disable-gpuDraw without GPU acceleration, to rule out driver problems.
visionfall-studio --versionPrint the version and exit.
visionfall-studio --helpList every option.

Where the studio keeps things#

WhatWhere
Settings and state — Windows%APPDATA%\VisionFall Studio
Settings and state — macOS~/Library/Application Support/VisionFall Studio
Settings and state — Linux~/.config/VisionFall Studio
Extensions — every platform~/.visionfall-studio/extensions