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.
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.
Windows
Windows 10 and 11 · 64-bit
macOS
macOS 13 Ventura or later
Linux
64-bit · glibc 2.31 or newer
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
- Version
- macOS 13 Ventura or later
- Architecture
- Apple Silicon or Intel — separate files
- Memory
- 8 GB minimum, 16 GB recommended
- Disk
- About 2 GB, plus the languages you install
- Architecture
- 64-bit (x86_64)
- C library
- glibc 2.31 or newer
- Tested on
- Ubuntu 20.04+, Debian 11+, Fedora 37+
- Memory
- 8 GB minimum, 16 GB recommended
- Disk
- About 2 GB, plus the languages you install
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#
- Open the folder you want help with. A session shares the workspace folders, so a window with no folder open cannot share.
- In Remote Assist, choose Share This Studio.
- 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#
- In Remote Assist, choose Connect to a Studio…
- Enter the Studio ID the other person read out.
- 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.
| Level | What the other person can do |
|---|---|
| View only | Read the shared folders. No changes, no terminal. |
| Editing | Read and change files, and open files on your screen. |
| Full control | Everything 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#
| Setting | Effect |
|---|---|
visionfall.remoteAssist.enabled | Turns code sharing on or off entirely. On by default. |
visionfall.remoteAssist.displayName | The name the other side sees. Defaults to the name of your open folder. |
visionfall.remoteAssist.defaultPermissions | The level offered first when someone connects — viewOnly, edit (default) or fullControl. |
visionfall.remoteAssist.requireApproval | Ask before letting anyone in, even with the password. On by default. |
visionfall.remoteAssist.trustedStudios | Names that may connect without approval each time, provided they have the password. |
visionfall.remoteAssist.showRemoteCursors | Show the other person's cursor and selection. On by default. |
visionfall.remoteAssist.maxFileSizeMB | Largest file a session will transfer. 32 MB by default. |
visionfall.remoteAssist.relayUrl | The relay that pairs two studios. Leave empty to use the one that ships with the studio. |
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#
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:
| Stage | What happens |
|---|---|
| Prepare | Checks what is already installed and works out what is needed. |
| Download | Fetches the toolchain for your operating system. |
| Extract | Unpacks it into place. |
| Configure | Wires the toolchain into your PATH so terminals can find it. |
| Extensions | Adds the editor extensions for that language. |
| Verify | Looks 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.
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#
| Key | Effect |
|---|---|
| Tab | Accept the highlighted suggestion. |
| ↑ ↓ | Move through the list. |
| Esc | Dismiss 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#
| Setting | Effect |
|---|---|
terminal.integrated.suggest.enabled | Turns terminal suggestions on or off. |
terminal.integrated.suggest.quickSuggestions | Whether suggestions appear automatically while you type. |
terminal.integrated.suggest.suggestOnTriggerCharacters | Whether typing a trigger character, such as a dash, opens suggestions. |
terminal.integrated.suggest.inlineSuggestion | Whether the shell's own inline suggestion is detected, and how it ranks. |
terminal.integrated.suggest.runOnEnter | Whether accepting with Enter (rather than Tab) also runs the command. |
terminal.integrated.suggest.cdPath | Offers folders on your $CDPATH from any directory. |
terminal.integrated.suggest.upArrowNavigatesHistory | Whether the up arrow reaches history from the first suggestion. |
terminal.integrated.suggest.showStatusBar | Shows 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.
| Option | Effect |
|---|---|
--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.
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 see | Why | What 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 connections | Repeated 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 it | The 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 terminal | Suggestions 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 load | The 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 incorrectly | A 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.
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#
| Command | Effect |
|---|---|
visionfall-studio . | Open the current folder. |
visionfall-studio --new-window | Open a new window instead of reusing one. |
visionfall-studio serve-web | Run the studio for a browser, on port 8000. |
visionfall-studio --disable-gpu | Draw without GPU acceleration, to rule out driver problems. |
visionfall-studio --version | Print the version and exit. |
visionfall-studio --help | List every option. |
Where the studio keeps things#
| What | Where |
|---|---|
| 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 |
