Omni-Codespace

Omni-Science Logo
Omni-Codespace

OWNED BY OMNI-SCIENCE

Preparing Omni-Codespace
Initializing workspace...
Loading the editor, checking cached language packs, and preparing the current project context.

User Guide & Safety

Omni-Codespace Manual

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.
Create & edit workspace files
  1. Open the sidebar.
  2. Use New File or New Folder.
  3. Click a file to open it in a tab.
  4. Type — autosave runs automatically.
  5. If continuous auto indent is enabled, formatting runs immediately when you turn it on and again after autosave.
Project-first code intelligence
  1. Open New Project.
  2. Choose a template, then enter a required unique project name.
  3. 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.

Autosave status

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 & highlighting
  • 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. .ts vs .js).
Useful shortcuts
Ctrl / Cmd + P Quick file picker (if enabled)
Ctrl / Cmd + F Find in file
Ctrl / Cmd + / Toggle comment
Alt + Shift + F Format document (language support required)

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.

File actions
  • 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.
Linked section

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.

Project templates
  1. Open the project picker from first run or the New Project button.
  2. Select a template such as HTML, Node.js, Minecraft Bedrock, Discord.js, Tauri, Capacitor, Python, Godot, Rust, C#, C++, or GameMaker.
  3. Enter a unique required project name, then create it. Files inside that root inherit the project context automatically.
Autocomplete behavior

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.

Minecraft Bedrock Script API

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.

Connect & pull
  1. Open GitHub → Settings and enter a fine-grained PAT/access key.
  2. Optionally enable Remember this key to keep it in local Omni-Codespace storage.
  3. Choose an accessible repository or type any owner/repository path the PAT can access.
  4. Choose a branch and workspace folder, then Pull.
Diff, commit & push
  1. Open Changes to see added, modified, and deleted files.
  2. Select a file to view a Monaco before/after diff.
  3. Enter a commit message and Commit. This creates a real Git commit without moving the remote branch yet.
  4. 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.
Binary and oversized files are not opened as text, but they remain in the Git tree and are preserved when you commit text changes.

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.

Requirements
  • 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.
Link a device folder
  1. In the explorer, open Linked.
  2. Click Link Folder and pick a folder on your device.
  3. Expand the folder tree. Click a file to open it.
  4. 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.

Create a linked folder (virtual)
  1. Click New Linked Folder.
  2. Name it (e.g. “Addon A”, “Addon B”).
  3. 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.
  4. 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.

Unlinking
  • 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

What Omni-Codespace does
  • 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.
What Omni-Codespace does NOT do
  • 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.
Your control
  • 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.
Security note: linked handles are stored by the browser and require permission; Omni-Codespace cannot bypass your browser security model.

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.