AIRUNCODE manual
The complete guide to the application: what each thing is, what it is for, how to use it step by step and what to do when something does not go as expected.
Getting started
- Introduction: what AIRUNCODE is
AIRUNCODE is an agent runtime that runs on your machine: it plans, writes, tests and ships software with the models you choose. This chapter explains how everything is organized.
- Installation, first launch and access
How to download AIRUNCODE for Windows, macOS or Linux, verify the download, get past operating-system warnings and sign in for the first time.
- Connecting models: key, account or local
The three ways to give AIRUNCODE a model — an API key, your Claude or ChatGPT subscription, or a local model with Ollama — and how to pick the model for each task.
- The main window: map of the application
A tour of each area of AIRUNCODE: menu bar, tasks, chat, text box, editor, explorer, terminal, usage bars and status bar.
Working with the agent
- The chat and tasks
How to create a task, write an instruction, attach files, mention files with @, use Plan and Agent modes, stop the agent and manage your task list.
- Permissions and trust profiles
How you decide what the agent may do: the three trust profiles (Manual, Supervised, Local autonomy), the approval card and the Security Guard.
- Editor, explorer and terminal
How to edit code in AIRUNCODE: tabs, search, AI editing (Ctrl+K), diff review, integrated terminals and running files.
- Context and memory
What the context window is, how to read the meter, when and how to compact, what snapshots are and how AIRUNCODE remembers your project (memory, knowledge graph and Blueprints).
- Several agents: Swarm, PM and plans
How to work with several agents at once: the Swarm (parallel workers with a file lock), the Project Manager that builds the plan and task-graph plans.
- Verification: tests, browser and audit
How AIRUNCODE checks its own work: the Test Runner with self-healing, the integrated browser to review what is built and the audit panel.
Shipping
- Git, GitHub and Cloudflare
How to version, publish and deploy from AIRUNCODE: the Git panel, GitHub pull requests, isolated spaces (worktrees) and the Cloudflare panel (Wrangler).
- Usage and costs
How to see and control what you spend: the usage bars (5-hour and weekly quota of your accounts, and API spend), budgets and the Cost Tracker, with no AIRUNCODE markup.
Creating
- Voice: dictation and narration
How to dictate instructions with your voice (local Whisper) and how to have AIRUNCODE read answers aloud (local Piper), with microphone and audio-output selection.
- V-CORE: the 3D engine
A guide to V-CORE, AIRUNCODE’s native game engine (Vulkan/SDL3): editing the world and terrain, weather and ocean, testing with Play, scripting with Lua, building models with Three.js and exporting the game.
- Design Studio
How to use AIRUNCODE’s Design Editor: visually edit a live frontend or a blank canvas, annotate changes for the agent and export to HTML, React and Tailwind.
Customize and extend
- Themes and appearance
AIRUNCODE’s 16 themes (from Pitch Black to GitHub Dark), how to change them, adjust density, font size and reduced motion, and sync appearance with your account.
- Skills, Marketplace and MCP
How to extend AIRUNCODE: install Skills (reusable instructions) from GitHub or locally, and connect MCP servers from the AIRUNCODE Store.
Account, remote and security
- Account, plans and billing
What the Free plan (4 keys of 48 h per month) and Pro (30 days, one-time payment) include, how to pay, what happens on expiry and how refunds work. Application access is separate from model cost.
- PWA and remote control
How to control your desktop AIRUNCODE from your phone or browser: linking devices, which permissions you grant (conversations, projects, files, metrics) and how to revoke them.
- Security and privacy
Which data stays on your machine and which travels, how your credentials are stored, which telemetry you can enable and how the agent perimeter and Computer Use mode work.
Reference
- Keyboard shortcuts
AIRUNCODE’s shortcut list: files, editing, search, navigation, running, terminal, chat and V-CORE. On macOS, use Cmd where Ctrl appears here.
- Troubleshooting
Solutions to AIRUNCODE’s most common problems: installation, sign-in, models that do not answer, exhausted quota, dictation, the 3D engine, deployments and the remote panel.
- Glossary
Short definitions of the terms AIRUNCODE uses: agent, session, workspace, BYOK, MCP, context window, Swarm, worktree, V-CORE and more.