Documentation

Haiku’s API, and what air/OS adds.

Write native apps for air/OS with Haiku’s API. These pages show where the fork differs from Haiku, kit by kit, with links back to Haiku’s own reference. The new Neural Kit is covered in full.

Start with Haiku’s reference

air/OS is built on Haiku, and Haiku’s documentation describes almost all of its API. These pages do not repeat it. They cover what the fork adds or changes, kit by kit, and document in full the one kit that is new: the Neural Kit.

What air/OS adds

To try your app, or air/OS itself, without a spare computer, run it in a virtual machine: QEMU and UTM set-up →

Kit by kit

KitWhat changedChanges
Interface KitMost of the fork's API work is here: fractional scaling, frame-accurate presentation, dark mode and colour emoji, plus a private accessibility interface.6 added 3 behaviour 2 private
Application KitNo public header changes. Notifications can now answer the app that posted them, and there are new system protocols for media keys and shutdown.1 behaviour 2 private
Game KitBDirectWindow works on a scaled desktop, in the frame buffer's own pixels.1 added 1 changed
Media KitNo public header changes. Device selection, default-change notifications and recording now work as documented, and a private now-playing library was added.3 behaviour 1 private
Device KitGame pad rumble, gap-free isochronous USB input, and a class for small auxiliary displays.3 added
Network KitLink speed, a Wi-Fi password parameter, a service order for the default route, and .local names.2 added 2 behaviour 1 private
Bluetooth KitBluetooth Low Energy, Secure Simple Pairing events, link policy and A2DP audio. The Haiku Book does not document the Bluetooth Kit; Haiku's headers are the reference.3 added 1 private
Support KitOne fix to an inline function that matters on ARM64.1 changed
Storage KitNo public header changes.1 behaviour
Package KitNo public header changes.1 private
Tracker Kit and Quick LookA public add-on API for Quick Look previews, plus private protocols for network shares and the Deskbar.1 added 1 private
Graphics drivers (accelerants)Optional hooks for several monitors on one device, per-monitor blanks, device-side copies to the screen, and resume.3 added
Device driversPower management for suspend, more PCI host topologies, USB device speed and keep-awake, and USB Audio 2.0 descriptors.5 added
Neural KitNew in air/OS: inference on NPUs, GPUs and the CPU, and speech recognition.new kit

No API changes: Kernel Kit, Locale Kit, Mail Kit, Translation Kit, MIDI 2 Kit, Layout API.

Compatibility

  • Apps built for Haiku run on air/OS unchanged. No class gained a virtual function or changed size; new structure fields use reserved space.
  • Apps that use these additions need air/OS. air/OS defines no compiler macro of its own. A kit that is new can be detected with __has_include(<NeuralKit.h>); additions to existing classes cannot, so build such apps for air/OS, as Summit ships separate builds for air/OS and stock Haiku.
  • Private headers may change. APIs marked Private are what the system’s own apps use. They are listed so you know they exist; there is no promise they stay as they are.
  • Headers and libraries come with the system’s development package, as on Haiku: the headers in /boot/system/develop/headers, the libraries to link with in /boot/system/develop/lib.

Compared with Haiku at 1f40bf7ced (hrev60207+139, 2 November 2026), the upstream commit air/OS master is based on, and air/OS master at bf526f982b (10 November 2026). Reviewed 10 November 2026.