ArgoBox OS - Desktop Environment
A full desktop operating system in your browser with 38 built-in apps, 15 animated wallpapers, virtual desktops, AI copilot, and optional container backend
ArgoBox OS — Desktop Environment
ArgoBox OS is a complete desktop operating system that runs entirely in your web browser. It provides a familiar workspace with a window manager, taskbar, start menu, 38 built-in applications, 15 animated wallpapers, 4 virtual desktops, and an AI copilot -- all without installing anything on your machine.
How to Access
Navigate to /user/os after logging in. Any account with portal:view permission can access ArgoBox OS. The desktop loads with a boot sequence, then presents your personalized workspace based on your assigned profile.
Feature Highlights
- 38 built-in apps across 8 categories: system tools, utilities, AI assistants, dev tools, media players, games, creative tools, and more
- 15 animated wallpapers using CSS gradients with twinkling stars, holographic overlays, and smooth color shifts
- 4 virtual desktops for organizing your workspace (switch with Ctrl+1 through Ctrl+4)
- Window tiling to arrange windows in grid, horizontal, vertical, or cascade layouts
- Spotlight search (Ctrl+K) to find and launch any app instantly
- OS Copilot (Ctrl+Shift+Space) for natural language commands powered by AI
- Lock screen (Ctrl+L) for stepping away
- Desktop widgets for at-a-glance information
- Profile-based access so administrators can control which apps each user sees
- Optional container backend for real terminal access, VS Code, and AI coding tools
App Catalog
System
| App | Description |
|---|---|
| Files | Virtual file system with sidebar navigation, grid and list views, 20+ file type icons, JSON syntax highlighting, and NAS storage indicators |
| Terminal | Terminal emulator with 25 commands, tab autocomplete, command history, and integration with the OS (open apps, change wallpaper, docker restart) |
| Settings | Wallpaper picker with live preview, accent colors, opacity and blur controls, font size, animation speed, system info, and container status |
| Task Manager | View running processes with CPU and memory usage, kill unresponsive apps |
| System Monitor | Real-time graphs for CPU, memory, disk, and network activity |
| Network | Network interface details, active connections, and traffic statistics |
| Disk Usage | Visual breakdown of storage usage across volumes |
| Log Viewer | Browse and filter system and application logs |
Utilities
| App | Description |
|---|---|
| Calculator | Standard and scientific calculator with keyboard input |
| Notes | Rich text note-taking with persistence |
| Calendar | Monthly calendar view with event management |
| Clipboard | Clipboard history manager -- never lose a copied item |
| Clock | World clock with multiple time zones, timer, stopwatch, and alarms |
| To-Do | Task management with priorities, categories, and completion tracking |
| Screenshot | Capture screenshots of your desktop |
| Color Picker | Pick colors with hex, RGB, and HSL value display |
| PDF Viewer | Read PDF documents in the browser |
| Markdown | Markdown editor with side-by-side live preview |
| Download Manager | Track and manage file downloads |
AI
| App | Description |
|---|---|
| AI Chat | Chat with AI using free providers (Groq, Gemini, OpenRouter, Ollama) or paid (OpenAI) |
| OpenClaw | ArgoBox's built-in AI assistant with full system context |
| Claude Code | Anthropic Claude coding assistant (requires container backend) |
| Codex | OpenAI Codex coding assistant (requires container backend) |
Dev Tools
| App | Description |
|---|---|
| Gitea Client | Browse repositories, view code, and manage Git operations |
| SSH Client | Connect to remote servers via SSH |
| Text Editor | Code editor with syntax highlighting for multiple languages |
Media
| App | Description |
|---|---|
| Music Player | Audio playback with playlist support |
| Image Viewer | View images with zoom, pan, and rotation |
| Video Player | Video playback with standard controls |
| Browser | Embedded web browser for accessing external sites |
Games
| App | Description |
|---|---|
| Minesweeper | Classic mine-clearing puzzle with multiple difficulty levels |
| 2048 | Slide and merge tiles to reach 2048 |
| Snake | Guide the snake to collect food and grow |
| Solitaire | Klondike Solitaire card game |
| Tetris | Classic falling-blocks puzzle with scoring |
Creative
| App | Description |
|---|---|
| Paint | Drawing canvas with brush tools, colors, shapes, and layers |
Other
| App | Description |
|---|---|
| Weather | Current conditions and forecast display |
| App Store | Browse and install additional applications |
Service Apps
Any service assigned to your account by an administrator appears as a launchable app in ArgoBox OS. These open in their own resizable window via iframe. Common examples include Plex, Grafana, Portainer, FileBrowser, Uptime Kuma, and many more.
Keyboard Shortcuts
General
| Shortcut | Action |
|---|---|
Alt+Tab |
Cycle through open windows |
Ctrl+K |
Open Spotlight search |
Ctrl+Shift+Space |
Open OS Copilot (AI assistant) |
Ctrl+L |
Lock screen |
F11 |
Toggle fullscreen |
Escape |
Close current overlay or menu |
Meta (Win/Cmd) |
Toggle start menu |
Virtual Desktops
| Shortcut | Action |
|---|---|
Ctrl+1 |
Desktop 1 |
Ctrl+2 |
Desktop 2 |
Ctrl+3 |
Desktop 3 |
Ctrl+4 |
Desktop 4 |
Window Tiling
| Shortcut | Action |
|---|---|
Ctrl+Alt+G |
Grid layout (2x2) |
Ctrl+Alt+H |
Horizontal split |
Ctrl+Alt+V |
Vertical split |
Ctrl+Alt+C |
Cascade |
Terminal
| Shortcut | Action |
|---|---|
Ctrl+C |
Cancel current command |
Ctrl+L |
Clear terminal |
Ctrl+U |
Clear line before cursor |
Ctrl+K |
Clear line after cursor |
Ctrl+A / Home |
Move to start of line |
Ctrl+E / End |
Move to end of line |
Ctrl+W |
Delete previous word |
Tab |
Autocomplete |
Up / Down |
Command history |
File Manager
| Shortcut | Action |
|---|---|
Ctrl+A |
Select all |
F2 |
Rename |
Delete |
Delete selected |
Enter |
Open selected |
Arrow keys |
Navigate |
User Profiles
Your administrator assigns a profile that determines which apps you can access and how much container resources you receive.
| Profile | Apps | Best For |
|---|---|---|
| Administrator | All 38+ apps, all services | Full system management |
| Developer | 25 apps + AI coding tools | Software development |
| Media Center | 16 apps + media services | Media management and playback |
| Minimal | 10 essential apps | Basic desktop usage |
| Demo | 21 apps, temporary session | Trying out ArgoBox OS |
AI Integration
ArgoBox OS includes built-in AI capabilities at no cost. Get a free API key from any of these providers:
- Groq -- Fastest inference, free tier at console.groq.com
- Google Gemini -- Free tier at aistudio.google.com
- OpenRouter -- Many free models at openrouter.ai
- Ollama -- Run models locally, no API key needed
The AI Chat app automatically detects which providers are configured. The OS Copilot (Ctrl+Shift+Space) uses the same providers to understand natural language commands like "open the terminal" or "change wallpaper to aurora."
Container Backend
For the full experience, an administrator can deploy the optional container backend. This provides:
- Real terminal -- A genuine bash shell instead of the simulated command set
- VS Code -- Full code-server instance running in your browser
- AI coding tools -- Claude Code and Codex with real file system access
- File operations -- Read and write real files on the server
Without the container backend, ArgoBox OS still works as a complete desktop environment. The terminal runs 25 simulated commands, the file manager uses a virtual file system, and container-dependent apps show an informational overlay.
Personalization
Your preferences are saved automatically and persist across sessions:
- Wallpaper -- Choose from 15 animated wallpapers in Settings
- Accent color -- Pick from 6 accent colors (Indigo, Violet, Emerald, Amber, Rose, Cyan)
- Window opacity -- Adjust window transparency (70-100%)
- Blur intensity -- Control glass morphism blur (10-30px)
- Font size -- Small, Medium, or Large
- Animation speed -- Normal, Fast, or None
- Icon positions -- Arrange desktop icons however you like
- Window positions -- Windows remember where you placed them
Developing Custom Apps
ArgoBox OS uses auto-discovery -- adding a new app requires zero changes to index.astro. Just create a new file.
Step 1: Create the Component
Create src/components/os/apps/MyApp.astro:
---
export const appMeta = {
id: 'my-app',
name: 'My App',
icon: 'fa-solid fa-star',
category: 'utilities',
defaultWidth: 700,
defaultHeight: 500,
singleton: true,
};
---
<script is:inline>
window.ArgoOS = window.ArgoOS || {};
window.ArgoOS.appFactories = window.ArgoOS.appFactories || {};
window.ArgoOS.appFactories['my-app'] = function (container, windowId) {
container.innerHTML = '<div style="padding:24px"><h2>Hello from My App!</h2></div>';
};
</script>
Step 2: Build and Deploy
That's it. The app auto-registers at build time. Administrator profiles (with enabled: ['*']) see it immediately. For other profiles, add the app ID to the enabled array in os-profiles.ts.
appMeta Fields
| Field | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Unique identifier, used in profile enabled lists and factory registration |
name |
string | yes | Display name shown in menus and title bars |
icon |
string | yes | Font Awesome 6 class (e.g. fa-solid fa-star) |
category |
string | yes | One of: system, utilities, ai, tools, games |
defaultWidth |
number | yes | Initial window width in pixels |
defaultHeight |
number | yes | Initial window height in pixels |
singleton |
boolean | no | If true, only one instance can be open at a time |
Factory Function
The factory function receives:
container-- DOM element to render into (the window body)windowId-- unique window identifier for event targeting
Use <script is:inline> (not bare <script>) to ensure the factory registers correctly at runtime.
Browser Support
ArgoBox OS works in modern browsers:
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+
A desktop or laptop screen is recommended. On mobile devices (under 767px width), a fallback message is displayed as the desktop experience requires a larger viewport.