Oz

Lightweight Terminal-first AI-native dev workspace.

Source code  ·  NPM registry

---

Oz is a lightweight open-source terminal (ADE) built on Tauri 2 + Rust and React 19. A native PTY backend with a WebGL renderer, an agentic AI side-panel that runs against your own keys or fully local models, plus a code editor, file explorer, source control with a git graph, and a web preview pane built in. About 7-8 MB on disk. No telemetry. No account.

Screenshots

Multi-tab terminal with WebGL rendering	Custom themes, presets, and background images
Web preview of local dev servers	Source control panel with git graph in history
Agentic AI workflow with edit diffs in the code editor

Features

Terminal

• xterm.js with WebGL renderer, multi-tab with background streaming
• GPU-accelerated block-based terminal with editor-like command input
• Native PTY backend via portable-pty (zsh, bash, pwsh, fish, cmd)
• Split panels (horizontal and vertical)
• Inline search, link detection, true-color
• Per-tab workspace environments on Windows (Local, or any installed WSL distro)

Code editor

• CodeMirror 6 (supports all popular languages - TS/JS, Rust, Python, Go, C/C++, Java, HTML/CSS, JSON, Markdown, etc.)
• Inline AI autocomplete with local model support
• AI edit diffs, accept or reject hunk by hunk
• Vim mode
• Ten built-in editor themes: Atom One, Aura, Copilot, GitHub Dark / Light, Gruvbox Dark, Nord, Tokyo Night, Xcode Dark / Light

Source control

• Stage / unstage hunks, commit (Cmd+Enter / Ctrl+Enter), push with upstream awareness
• Branch display including detached HEAD state
• Git history pane with a real commit graph (lane rendering for merges and branches)
• Commit search and filter, click through to the remote commit page

File explorer

• Catppuccin icon theme
• Fuzzy search, keyboard navigation, inline rename, context actions
• Attach files and selections directly to the AI side-panel

Web preview

• Auto-detects local dev servers and opens them in a preview tab
• External URL preview via a native child webview

Themes and customization

• Custom themes built in-app, switch between bundled presets and your own
• Create your own themes, share them or import from the community
• Background images with adjustable opacity and blur
• Editor theme is independent from the app theme

AI

• BYOK providers: OpenAI, Anthropic, Google (Gemini), Groq, xAI (Grok), Cerebras, OpenRouter, DeepSeek, Mistral, plus any OpenAI-compatible endpoint
• Local / offline: LM Studio, MLX, Ollama
• Agentic workflow: plans, sub-agents, project memory via OZ.md, file read / write / edit / multi-edit / grep / glob, bash with approval gating, background processes
• Composer: snippets via #handle, files via @path, slash commands, voice input, attach-to-agent from explorer or selection
• Custom agents with their own system prompt and tool subset
• Plan mode for multi-step work, generates and confirms before doing

Install

Via NPM (Cross-platform Launcher) — recommended during the test phase

You can install and launch the Oz desktop application directly from your shell using NPM or npx:

# Run immediately without global installation
npx @codecollab.co/oz

# Or install globally and run
npm install -g @codecollab.co/oz
oz

This is the smoothest option while Oz is still unsigned (see Unsigned builds below). The launcher downloads the app over HTTPS — which avoids the macOS "damaged" / Windows SmartScreen prompts entirely — installs it into your Applications / Start Menu, and launches it detached. Extra commands:

oz install     # download + install without launching
oz uninstall   # remove the installed app and cached binaries

Desktop Installers

Latest precompiled installers (DMG, MSI, DEB, RPM, AppImage) are on the Releases page. Oz auto-updates from there. If you download these through a browser, read Unsigned builds first.

Unsigned builds

Oz is not code-signed or notarized yet (no paid Apple/Windows certificates during the test phase). The app itself is safe — the OS just can't verify a signature. The npx @codecollab.co/oz launcher above sidesteps all of this and is the recommended path. If you instead downloaded an installer from the Releases page through a browser, clear the OS block once:

• macOS ("Oz is damaged and can't be opened"): drag Oz.app into /Applications, then run:

  xattr -dr com.apple.quarantine /Applications/Oz.app

  Open it normally afterwards. (On Apple Silicon the "damaged" message is Gatekeeper refusing an un-notarized app, not a corrupt download.)
• Windows ("Windows protected your PC"): click More info → Run anyway. Or right-click the installer → Properties → tick Unblock → OK.
• Linux: chmod +x Oz_*.AppImage and ensure FUSE is installed. Without FUSE: ./Oz_*.AppImage --appimage-extract-and-run. The .deb / .rpm packages don't need this.

Windows notes

• On first launch Windows shows "Windows protected your PC" because Oz isn't code-signed yet. Click More info then Run anyway.
• Default shell detection: pwsh.exe (PowerShell 7+) -> powershell.exe (Windows PowerShell 5.1) -> cmd.exe.
• WSL is a first-class workspace environment, not a wrapped subprocess.

Linux notes

• Arch / AUR: yay -S oz-bin (or paru, etc.). Tracks the latest release.
• NixOS / Nix: use the official flake — nix profile install github:codecollab-co/oz (non-NixOS), or import the flake and add inputs.oz.packages.${pkgs.system}.oz to environment.systemPackages (NixOS). The nixosModules.oz output is also available for a simpler setup.
• AppImage: needs FUSE. Without it: ./Oz_*.AppImage --appimage-extract-and-run. On Wayland with rendering glitches, try WEBKIT_DISABLE_DMABUF_RENDERER=1. Otherwise the .deb / .rpm packages link against the system GTK stack and tend to be smoother.

Configure AI

1. Open Settings -> AI.
2. Pick a provider and paste your API key. For local inference, point Oz at your LM Studio / MLX / Ollama endpoint.
3. Keys are written to the OS keychain via keyring. They never touch disk or localStorage.

Build from source

Prerequisites

• Rust (stable), https://rustup.rs
• Node 20+ and pnpm
• Tauri prerequisites for your platform, https://tauri.app/start/prerequisites/

Run

pnpm install
pnpm tauri dev          # development
pnpm tauri build        # production bundle

Checks

pnpm exec tsc --noEmit                                            # frontend type-check
cd src-tauri && cargo clippy --all-targets --locked -D warnings   # Rust lint (matches CI)
cd src-tauri && cargo test --locked                               # Rust tests

Tech stack

Tauri 2, Rust, portable-pty, React 19, TypeScript, Vite, xterm.js, CodeMirror 6, Vercel AI SDK v6, Tailwind v4, shadcn/ui, Zustand.

Contributing

Issues and PRs are welcome! Feel free to open issues, suggest features, or submit pull requests. See CONTRIBUTING.md for more details.

License

Oz is licensed under the Apache-2.0 License. For more information on our dependencies, see Apache License 2.0.

Star history