Employee access required
This tool is marked employee-only. Sign in with an employee account from the main Omni-Science site to access it.
Time's Up!
Your free time for this tool has been used. Sign in for more time or upgrade to Omni-Pass for unlimited access.
Get Omni-PassOmni-Codespace

OWNED BY OMNI-SCIENCE
User Guide & Safety
Omni-Codespace Manual
Guide Index
Omni-Codespace stores its workspace locally in your browser/platform storage, plus optional Linked device files/folders. GitHub Source Control is opt-in and only contacts GitHub when you connect, pull, inspect remote history/diffs, commit, or push.
Getting started
Omni-Codespace has two “storage modes” that can be used together:
- Workspace files (default): stored in your browser using IndexedDB. Works offline after first load.
- Linked files/folders: optional. You link real files from your device so autosave writes back to them.
- Open the sidebar.
- Use New File or New Folder.
- Click a file to open it in a tab.
- Type — autosave runs automatically.
- If continuous auto indent is enabled, formatting runs immediately when you turn it on and again after autosave.
- Open New Project.
- Choose a template, then enter a required unique project name.
- Omni-Codespace creates starter files and auto-loads the right context for files inside that project.
Editor & tabs
The main editor is Monaco (VS Code’s editor). Each open file becomes a tab.
Tabs show a small dot:
- Yellow: changes are pending save.
- Green: saved successfully.
For linked files, a green dot means it saved to the browser AND wrote back to the original device file.
- Autocomplete shows while typing (no “dot-only” requirement).
- Semantic highlighting improves as you install the right type packs.
- File extension influences language mode (e.g.
.tsvs.js).
Sidebar explorer & search
The sidebar contains your file explorer. It scrolls on both mobile and desktop. Use the search box to filter files by name/path.
- Create new files/folders. New script files inside a project folder inherit that project's codebase automatically. Script files outside project roots ask which codebase they belong to.
- Rename, delete (workspace files only).
- Click a file to open it; on mobile the sidebar auto-hides after opening.
At the top of the explorer you’ll see Linked. This area is for device-linked folders/files and virtual linked folders you create.
Projects & context-driven autocomplete
Omni-Codespace is project-first now. Choose a template, name the project, and the workspace keeps matching autocomplete to that project context automatically.
- Open the project picker from first run or the New Project button.
- Select a template such as HTML, Node.js, Minecraft Bedrock, Discord.js, Tauri, Capacitor, Python, Godot, Rust, C#, C++, or GameMaker.
- Enter a unique required project name, then create it. Files inside that root inherit the project context automatically.
JavaScript and TypeScript files inside a project root inherit that project's environment immediately and do not re-prompt on open or autosave. Standalone script files outside project roots ask what codebase they belong to so suggestions stay accurate.
Bedrock typings stay available by default. If you work on Minecraft addons/scripts, select the relevant packs and keep them enabled.
GitHub source control
Open GitHub from the Explorer. Omni-Codespace can work directly with repositories your GitHub PAT can access.
- Open GitHub → Settings and enter a fine-grained PAT/access key.
- Optionally enable Remember this key to keep it in local Omni-Codespace storage.
- Choose an accessible repository or type any
owner/repositorypath the PAT can access. - Choose a branch and workspace folder, then Pull.
- Open Changes to see added, modified, and deleted files.
- Select a file to view a Monaco before/after diff.
- Enter a commit message and Commit. This creates a real Git commit without moving the remote branch yet.
- Push advances the selected branch using a non-force fast-forward update. If GitHub changed remotely, Omni-Codespace stops and asks you to pull first.
Linked workspace (device linking)
Linked workspace lets you connect real folders/files from your device so Omni-Codespace behaves like a lightweight IDE: open a file, edit it, and autosave writes back to the original file.
- Browser: Chrome or Edge (File System Access API).
- Secure context: HTTPS (or localhost).
- If you’re running inside an iframe, the parent page must allow file picker permissions.
- In the explorer, open Linked.
- Click Link Folder and pick a folder on your device.
- Expand the folder tree. Click a file to open it.
- Edits autosave. If permission is granted, it writes back to the same file on disk.
Tip: The first time, the browser may ask for permission. Grant read/write to enable true IDE-style saving.
- Click New Linked Folder.
- Name it (e.g. “Addon A”, “Addon B”).
- Open that folder and click the existing Link Files control/link icon to choose one or more files from your device in the same picker.
- Those files will appear under the folder and autosave back to the originals.
This matches the “two addons” workflow: one linked folder per addon, each containing the linked files you edit most. On desktop, use Shift/Ctrl/Cmd selection in the file picker to link many files at once.
- Unlink a linked file: click the unlink icon next to the file.
- Unlink a linked folder (virtual): unlink removes only the mappings, not your device files.
- Unlink a device folder: removes the folder link and any cached file mappings you opened from it.
Safety guarantee
- Edits code in your browser using Monaco.
- Saves workspace files into your browser (IndexedDB).
- If you link device files, writes back only to the specific files you explicitly linked/opened.
- No Omni-Science server upload is required for workspace storage. GitHub traffic goes directly to GitHub's API only when you use GitHub Source Control.
- No GitHub account is required unless you choose to use GitHub Source Control.
- No background Git push/pull: repository mutations require an explicit Commit/Push action.
- No silent access to your device: linking requires an explicit picker + permission.
- You can unlink folders/files at any time from the Linked section.
- Workspace files remain available offline (until you clear site data).
- If you clear site storage in your browser settings, all workspace files and link mappings are removed.
Troubleshooting
- Linked shows “unsupported”: Use Chrome/Edge and ensure you’re on HTTPS (or localhost).
- Save dot stays yellow on linked files: Permission wasn’t granted or was revoked. Re-link the file/folder and allow read/write.
- Inside an iframe: the parent page must allow file picker permissions; otherwise linking may be blocked.
- Slow performance: Disable unused extensions, reduce open tabs, and avoid extremely large single files.