Linux Amiga Emulation Layer

lxa runs AmigaOS executables natively on Linux, similar to how WINE runs Windows programs. It combines a 68000 CPU emulator with AmigaOS library implementations, bridging system calls to Linux I/O and filesystem operations.

The long-term goal is for lxa to become a viable development platform for Amiga software on Linux — enabling Amiga developers to write, test, and run productivity applications and IDEs directly on commodity hardware (Linux PC, Raspberry Pi) without needing real Amiga hardware. RTG (Retargetable Graphics) via Picasso96 is the primary display strategy, targeting full true-color screens at arbitrary resolutions.

• ✨ Direct execution of Amiga programs on Linux
• 🖥️ Interactive Shell with scripting support
• 📁 Virtual filesystem with case-insensitive path resolution
• 🔄 Preemptive multitasking with signals and message passing
• 🛠️ Command-line tools (DIR, TYPE, COPY, DELETE, etc.)
• ⚙️ Flexible configuration via INI files and environment variables

# Build and install
./build.sh
make -C build install

# Run the Amiga Shell
usr/bin/lxa

On first run, lxa automatically creates ~/.lxa/ with system files.

# Run the interactive Shell
usr/bin/lxa

# Execute an Amiga program
usr/bin/lxa path/to/program

# Run with a script
usr/bin/lxa SYS:System/Shell myscript.txt

$ usr/bin/lxa
lxa Shell v1.0
1.SYS:> dir
S/          C/          Libs/       Devs/       T/

1.SYS:> type SYS:S/Startup-Sequence
; Startup script
echo "Welcome to lxa!"

1.SYS:> quit

• CMake 3.16+
• GCC or Clang
• m68k-amigaos-gcc cross-compiler (bebbo/amiga-gcc)

./build.sh
make -C build install

See doc/building.md for detailed build instructions.

lxa automatically creates ~/.lxa/ on first run with:

• Default configuration file
• System directory structure (S/, C/, Libs/, Devs/)
• Startup script

Create or edit ~/.lxa/config.ini:

[system]
rom_path = /usr/share/lxa/lxa.rom

[drives]
SYS = ~/.lxa/System
Work = ~/amiga_projects
DH1 = /mnt/data/amiga

[floppies]
DF0 = ~/.lxa/floppy0

[display]
rootless_mode = true

[assigns]
KP2 = /path/to/kickpascal2
LIBS = /path/to/kickpascal2/libs

See doc/configuration.md for details.

The App-DB (../lxa-apps/) contains Amiga applications with environment manifests:

# List available apps
./tests/run_apps.py --list

# Run an app
./tests/run_apps.py kickpascal2

# Run with custom timeout
./tests/run_apps.py kickpascal2 --timeout 30

# Run all apps
./tests/run_apps.py --all

Each app has an app.json manifest defining its assigns, required libraries, and test configuration.

lxa [options] [program]

• -c <config> - Specify configuration file
• -r <rom> - Specify ROM path
• --assign <name=path> - Replace or create an assign from the command line
• --assign-add <name=path> - Append a path to an existing multi-assign
• -a <name=path> - Legacy alias for --assign
• -d - Enable debug output
• -v - Verbose mode

rootless_mode = true keeps the Workbench screen hidden and exposes application windows as separate host windows, which is the recommended default for app launches.

Examples:

lxa --assign APPS=../lxa-apps --assign Cluster=/path/to/Cluster APPS:Cluster2/bin/Cluster2/Editor
lxa --assign LIBS=/path/to/base/libs --assign-add LIBS=/path/to/override/libs SYS:System/Shell

# Interactive Shell
lxa

# Run a program
lxa myprogram

# Custom system root
lxa -s /path/to/amiga myprogram

# Debug mode
lxa -d -v myprogram

• exec.library: Memory management, multitasking, signals, messages
• dos.library: File I/O, locks, directories, processes, pattern matching (including (a|b) alternation), SetFileSize, SetFileDate, ExAll, MakeLink, ReadLink, InternalLoadSeg, NewLoadSeg, RunCommand, GetSegListInfo, CON:/RAW: handler, assign-backed DeviceProc()/GetDeviceProc() coverage
• utility.library: Tag lists, hooks, utility functions including direct regression coverage for tag-list cloning/filtering/mapping, pack/unpack helpers, named-object namespaces, date conversion helpers, 32-bit math helpers, HookEntry-driven hook dispatch, and unique ID generation
• graphics.library: BitMap, RastPort, drawing primitives (WritePixel, Draw, RectFill, ScrollRaster, AreaFill, pixel arrays), palette/pen matching coverage via ObtainPen()/ObtainBestPenA() regressions
• intuition.library: Screen/window management, IDCMP input (SIZEVERIFY, MENUVERIFY, REQSET/REQCLEAR, DELTAMOVE), gadgets, menus, EasyRequest, BOOPSI (icclass/modelclass/gadgetclass, ICA_TARGET/ICA_MAP inter-object communication)
• gadtools.library: GadTools gadgets (buttons, strings, checkboxes, cycles, sliders with rendered live level values, MX), menu layout helpers, and IDCMP/refresh wrapper coverage
• asl.library: File, font, and screen mode requesters, including public AllocAslRequestTags()/AslRequestTags() varargs entry-point coverage
• locale.library: Locale management, .catalog loading and lookup, character classification/case conversion, StrConvert/StrnCmp, FormatDate, FormatString, ParseDate
• keymap.library: Default-keymap queries/updates plus MapRawKey() / MapANSI() translation coverage, including dead-key and string-sequence handling
• diskfont.library: Font loading from FONTS: bitmap .font files, including proportional and multi-plane color bitmap fonts, covered NewFontContents() / DisposeFontContents() helpers and diskfont control-tag queries, plus Phase 88 outline-font wrappers (E*Engine, OpenOutlineFont() / CloseOutlineFont()), font-file write helpers, and built-in charset metadata queries
• mathieeesingbas.library: IEEE single-precision basic math (12 functions)
• mathieeedoubbas.library: IEEE double-precision basic math (12 functions)
• input.device: Handler-chain management (IND_ADDHANDLER / IND_REMHANDLER), held-qualifier snapshots via PeekQualifier(), transient qualifier-bit preservation on injected events, repeat timing configuration, and direct event injection/dispatch coverage for IND_WRITEEVENT / IND_ADDEVENT
• gameport.device: Covered init/open/close/expunge lifetime semantics, controller-type and trigger query/set commands, NSCMD_DEVICEQUERY, pending GPD_READEVENT requests with AbortIO(), and hosted mouse-event delivery through the shared input stack
• keyboard.device: Covered CMD_CLEAR, KBD_READEVENT, KBD_READMATRIX, reset-handler registration/acknowledgement, per-open read queues, shared Intuition/raw-key event capture, and current key-matrix snapshots aligned with the hosted input stack
• narrator.device: Hosted speech-request validation with default V37 parameters, phoneme-stream write handling, generated mouth/word/syllable sync events for CMD_READ, and flush/reset coverage for translator-driven speech workflows
• parallel.device: Hosted shared/exclusive open semantics, PDCMD_QUERY / PDCMD_SETPARAMS, loopback-backed CMD_READ / CMD_WRITE, start/stop/flush/reset handling, pending-read abort coverage, and deferred-expunge lifetime tests
• ramdrive.device: Hosted in-memory RAD:-style block storage with CMD_READ / CMD_WRITE / TD_FORMAT, trackdisk-compatible geometry/status queries, ETD change-count validation, and KillRAD() / KillRAD0() coverage
• scsi.device: Hosted HD_SCSICMD support for core SCSI-direct commands (INQUIRY, REQUEST SENSE, MODE SENSE(6), READ CAPACITY, READ/WRITE 6/10/12, and sync/cache no-ops), encoded unit validation, per-unit logical block storage, autosense/check-condition coverage, and deferred-expunge lifetime tests
• console.device: Terminal I/O with CSI escape sequences, keyboard input, CONU_LIBRARY access, and covered keymap command/query support
• trackdisk.device: Hosted .adf-backed sector I/O (TD_READ / TD_WRITE / TD_FORMAT / TD_SEEK, plus ETD_* variants and raw track TD_RAWREAD / TD_RAWWRITE) with geometry/status support, classic error handling, covered TD_ADDCHANGEINT/TD_REMCHANGEINT request lifetime semantics, and deferred-expunge plus abort coverage
• audio.device: Channel allocation, timed CMD_WRITE playback, ADCMD_SETPREC / ADCMD_PERVOL / ADCMD_FINISH / ADCMD_WAITCYCLE, and end-of-sample audio interrupt delivery

Built-in C: commands with full AmigaDOS template support:

• DIR - List directory contents
• TYPE - Display file contents
• COPY - Copy files and directories
• DELETE - Delete files and directories
• MAKEDIR - Create directories
• RENAME - Rename files
• PROTECT - Set file permissions
• LIST - Detailed directory listing
• ASSIGN - Manage drive assignments
• And more...

• Interactive prompt with line editing
• Script execution (Execute API)
• Control flow: IF/ELSE/ENDIF, SKIP/LAB
• Built-in commands: ECHO, CD, PATH, PROMPT, ALIAS
• Argument parsing with ReadArgs

• Architecture - Internal design and components
• Building - Detailed build instructions
• Configuration - Configuration guide
• Testing - Testing guide for developers
• Developer Guide - Development workflow and standards
• AGENTS.md - AI agent development guidelines
• roadmap.md - Project roadmap and status

Version 0.10.13 - DirectoryOpus deeper workflows (Phase 159b): four new dopus_gtest.cpp interaction tests landed — ZPathEntryAreaRespondsToClick (lister-pane click survives without window loss), ZButtonBankClickPreservesUI (button-bank click does not crash; window count non-decreasing), ZProjectMenuFirstItemActivates (RMB-drag through Project menu Item[0] using lxa_get_menu_info for coordinates, ESC-dismiss any popup), and ZWindowTitleDocumentsDOpusRTAbsence (pins the "DOPUS.1" title and documents the DOpusRT/Phase 167 dependency for the version+memory string). Phase 159b item 3 (BltBitMap glyph hook to re-enable DISABLED_TextHookCapturesKnownDOpusLabels) promoted to its own Phase 159c because the implementation requires a glyph atlas detector + glyph→char mapping infrastructure that is multi-day work in its own right. 18/18 DOpus tests pass; full suite 77/77.

Version 0.10.12 - DirectoryOpus structural characterization (Phase 159).

Version 0.10.9 - SetWindowTitles() title-bar repaint (Phase 158): _intuition_SetWindowTitles() now redraws the window frame immediately after changing window->Title, so runtime title changes are visible without moving or refreshing the window. New SetWindowTitles sample, setwindowtitles_gtest.cpp, and DPaint Screen Format title-bar regression coverage.

Version 0.10.8 - Button / menu accelerator underline (Phase 157): _graphics_Text() renders FSF_UNDERLINED text with a 1-pixel underline, and GadTools labels now translate accelerator markers into underlined button/menu text. New text_underline_gtest.cpp coverage.

Version 0.10.4 - PROPGADGET recessed track-frame rendering (Phase 152): _render_gadget() PROPGADGET branch now draws a 3D recessed frame (shadow pen on top/left, shine pen on bottom/right) on the outer perimeter of every prop gadget that does not opt out via PROPBORDERLESS. Frame applies independently of AUTOKNOB so custom-knob prop gadgets also receive standard chrome. New samples/intuition/propgadget.c and tests/drivers/propgadget_chrome_gtest.cpp (7 tests) plus full-suite regression check (74/74 pass).

Version 0.10.3 - DPaint Screen Format custom-panel refresh validation (Phase 151): tightened ScreenFormatDialogSectionsContainVisibleContent to assert the Choose Display Mode custom list contains >200 non-background pixels, the Display Information and Credits headings are visible, and the text hook captures all three semantic headings. This confirms the existing initial IDCMP_REFRESHWINDOW path in OpenWindow() triggers DPaint's custom panel paint. Targeted DPaint regression passes.

Version 0.10.2 - OpenMonitor() / CloseMonitor() + GfxBase->MonitorList real implementation (Phase 150b): implemented monitor list initialization and lookup for default/PAL/NTSC monitor specs, added monitor-list coverage, and fixed DPaint Screen Format capture timing after window creation.

Version 0.10.0 - Deferred-paint trigger / forced full redraw (Phase 149): added lxa_force_full_redraw() host API with EMU_CALL_INT_FORCE_FULL_REDRAW (3030) — ROM VBlank hook walks FirstScreen→FirstWindow chain and sends IDCMP_REFRESHWINDOW to all eligible windows on demand. Fixed display_read_pixel() rootless-mode bug: in rootless mode g_active_display is NULL so all CountScreenContent calls silently returned 0; added fallback that reads from display_window_t pixel buffers with correct host_x/host_y coordinate translation. Added lxa_set_active_window() / display_set_active_by_index() API. Re-enabled MaxonBasicTest.ZMenuDragPixelStability with corrected scan region. 72/72 pass.

Version 0.9.32 - Typeface deeper workflows — textfield.gadget integration and Preview window (Phase 147c): root-caused BGUI_EXTERNAL_GADGET class failure (ExternalObject wrapping textfield.gadget was NULL because InitExtClass() fallback in libfunc.c was never reached); fixed by removing orphaned debug kprintfs that masked the control flow — InitExtClass() now correctly initialises in-process when the gadget file is absent. With ExternalObject working, PreviewWndObj is non-NULL and WindowOpen succeeds. Three new Typeface tests: TextFieldGadgetLoads, PreviewWindowOpens, ZPreviewWindowHasContent. 70/72 pass (2 pre-existing: maxonbasic_gtest, dopus_gtest).

Version 0.9.31 - Typeface window geometry investigation (Phase 147b): root-cause analysis confirmed that 194×138 is the correct BGUI minimum window size for Typeface on a first-run PAL/topaz-8 system. The 280×195 reference came from a saved-prefs state on FS-UAE, not a comparable baseline. Mathematical proof: Box.Height=138 from Typeface's do-while loop; BGUI WinSize min-width=194 from CharGadget (8 cols × 20px) + PropObject(16) + borders. WindowGeometryMatchesTarget test asserts 194×138 ±4px. 72/72 pass.

Version 0.9.30 - Typeface custom-screen window chrome (Phase 147a): fixed per-screen-type host-window architecture; rootless+Workbench → each child window is its own X11 window; rootless+custom-screen → screen owns one host window with chrome rendered into the screen bitmap. New WindowChromeIsRendered test. 72/72 pass.

Version 0.9.27 - Intuition WZOOM gadget and Devpac border rendering (Phase 145): added case GTYP_WZOOM: to _render_window_frame() with outlined-rectangle imagery; WZOOM gadget created in _create_window_sys_gadgets() when WFLG_HASZOOM is set; WA_Zoom tag now sets WFLG_HASZOOM; ZipWindow behavior wired in _handle_sys_gadget_verify. New ZoomWindow sample. New devpac_scrollbar_gtest.cpp (3 tests). 71/71 pass.

Version 0.9.26 - ProWrite About dialog re-enabled (Phase 140): fixed View-menu drag coordinates (was using Project-menu x+240, now correctly targets View menu at x+396; item y was y+150 hitting Quit, now y+15 for the About item). DismissWindow now iterates gadgets in reverse order and clicks the first non-zero-size gadget, correctly targeting ProWrite's OK button (gadget[0], size 60×15). Diagnostic helper tests removed. Full suite 68/68.

Version 0.9.21 - GadTools submenu pixel test re-enabled (Phase 139): GadToolsMenuPixelTest.SubmenuHoverDoesNotCorruptLowerMainItems re-enabled with no code change required; the hang was already resolved by the Phase 132/133 menu compose + backing-store work. Verified stable across 5 consecutive runs. Full suite 68/68.

Version 0.9.20 - Resize-rendering test reliability fix (Phase 138): re-enabled GadToolsGadgetsPixelTest.ResizeKeepsSizeGadgetBordersClean. The size-gadget chrome WAS being re-rendered correctly after a resize — the test simply sampled the screen too early. _intuition_SizeWindow updates Window->Width/Height before invoking _render_window_frame, so polling GetWindowInfo for the final dimensions is not proof of rendering completion. Replaced the fixed 20-VBlank settle wait with an event-driven loop that polls the size-gadget pixel area until non-background pixels appear (proof that _render_gadget for GTYP_SIZING has executed). Also reverted a stray LPRINTF(LOG_INFO) in _graphics_Draw left over from Phase 134 debugging (per AGENTS §6.3). CMakeLists gadtoolsgadgets_pixels_c_gtest shard FILTER updated to include the re-enabled test. Full suite 68/68.

Version 0.9.19 - RunCommand exit-code propagation (Phase 137): _dos_RunCommand previously installed pr_ExitCode/pr_ExitData after _dos_CreateNewProc had already enqueued the child and yielded to it, so a fast child could call Exit(rc) before the runcommand cleanup was wired up — the child's return code was lost and the parent always saw result == -1. _dos_CreateNewProc now honours the RKRM NP_ExitCode / NP_ExitData tags and threads a user-supplied exit callback through lxa_dos_process_exit_cleanup (so internal teardown still runs first), and _dos_RunCommand passes its result-capture callback via those tags atomically as part of process construction. DosTest.LoadSegRuntime re-enabled; full suite 68/68.

Version 0.9.9 - BlitzBasic 2 ted editor deep dive (Phase 135): original blitter/copper hypothesis invalidated by instrumentation — BB2 emits zero blitter and zero copper writes during startup. Real root cause: BB2 opens an "About BlitzBasic 2" requester with garbage requested coordinates (LE=32614, TE=32729) and WaitPort()s on its UserPort, blocking the editor until the user clicks "OKEE DOKEE". The pre-existing off-screen clamp in _intuition_OpenWindow clipped the requester to a single pixel at (639,255), making the dismiss button unreachable. Fix: when a requested window position would place the window mostly off-screen, recentre it on the screen instead of clipping to the edge. Also: RAWKEY events now route to IntuitionBase->ActiveWindow instead of the window under the mouse pointer (real Amiga semantics), so BB2 receives keyboard input correctly after the requester is dismissed. StartupOpensVisibleIdeWindow flipped from upper-bound (<10 non-grey pixels) to lower-bound (>1000) assertion. All 10 BB2 driver tests pass; About requester + PROJECT menu render correctly (verified via tools/screenshot_review.py).

Version 0.9.8 - DirectoryOpus button bank rendering (Phase 134): root cause diagnosed via Phase 130 text hook — DOpus renders its main button bank (Copy/Move/Rename/Makedir/Hunt/Run/Comment etc.) via a VBlank-driven timer event that fires ~400 VBlanks after startup, beyond the previous 150-iteration settle window. Fixed by bumping settle to 600 VBlank iterations. TextHookCapturesKnownDOpusLabels now asserts specific button-bank label words. All diagnostic LPRINTFs from the previous investigation session cleaned up.

Version 0.9.7 - Menu double-buffering (Phase 133): _render_menu_bar() and _render_menu_items() in lxa_intuition.c now render into a persistent off-screen compose BitMap and atomic-BltBitMap the completed frame to the screen, eliminating pixel flicker during menu drags on ASM-One and MaxonBASIC. ZMenuFlickerCheck upgraded to a ±5% pixel-stability assertion; new ZMenuDragPixelStability test guards the MaxonBASIC editor area against menu residue. Full suite 67/67 pass.

Version 0.9.6 - SMART_REFRESH backing store validation (Phase 132): new BackingStoreTest sample (samples/intuition/backingstoretest.c) drives a dialog-over-window obscure/uncover cycle through three deterministic stages; new backingstore_gtest.cpp driver (4 tests) probes pixels in the formerly-obscured region and proves Phase 111's backing store correctly restores SMART_REFRESH content on uncover. Defensive IS_SMARTREFRESH skip in DamageExposedAreas() removed; apps now receive correct IDCMP_REFRESHWINDOW messages on uncover (matching real Amiga behaviour) without losing pixels. Full suite 67/67 pass.

Version 0.9.5 - Intuition event log + menu introspection (Phase 131): circular 256-entry event log (lxa_push_intui_event, lxa_drain_intui_events) records OpenWindow/CloseWindow/OpenScreen/CloseScreen events from lxa_dispatch.c; lxa_get_menu_strip() traverses the emulated Intuition MenuStrip linked list to expose menu titles, item names, enabled/checked state, and geometry; LxaTest::DrainEvents(), GetMenuStrip(), GetMenuNames() helpers added to the test framework. Tests in simplemenu, maxonbasic, devpac, and api drivers.

Version 0.9.4 - Text() interception (Phase 130): lxa_set_text_hook() / lxa_clear_text_hook() via EMU_CALL_GFX_TEXT_HOOK; ROM _graphics_Text() fires the hook on every render call; semantic text assertions in api, dopus, and kickpascal drivers.

Version 0.9.3 - Screen-mode emulation (Phase 128 + Phase 129 partial): display pipeline optimization with dirty-region scanline tracking and SSE2 planar-to-chunky acceleration; ROM-side screen-mode virtualization complete — g_known_display_ids[] expanded to 36 ECS entries, GetDisplayInfoData(DTAG_DIMS) returns realistic raster ranges, BestModeIDA() honours DIPFMustHave/MustNotHave, OpenScreenTagList() accepts RTG-depth requests and maps unknown display IDs to the closest physical mode (Wine strategy). PPaint and FinalWriter validation deferred to Phase 139 (RTG app validation via Picasso96).

Version 0.9.1 - Memory access fast paths (Phase 127): direct bswap-based 16/32-bit RAM and ROM reads/writes; __builtin_expect hints on hot paths.

Version 0.9.0 - Profiling infrastructure (Phase 126): per-EMU_CALL counters + timing; --profile flag; tools/profile_report.py; baseline latency tests across six app drivers.

Version 0.8.90 - lxa.c decomposition (Phase 125): 9,960-line monolith split into lxa_custom.c, lxa_dispatch.c, lxa_dos_host.c, lxa_internal.h, lxa_memory.h; lxa.c reduced to ~1,658 lines.

See roadmap.md for detailed status and future plans.

• CPU: 68000 only (no 68020+ or FPU)
• Third-party libraries such as commodities.library, rexxsyslib.library, datatypes.library, and dopus.library are not shipped in ROM and must be installed on disk in LIBS:. Stub disk libraries are provided for amigaguide.library, req.library, reqtools.library, powerpacker.library, and arp.library (apps can OpenLibrary them but all functions return safe failure values).
• RTG: Picasso96 (Picasso96API.library) and cybergraphics.library are not yet implemented — this is the active development focus (Phases 137–139). ECS screen modes (LORES/HIRES, PAL/NTSC) are supported; RTG true-color modes are not yet available.
• GUI Apps: SDL2 window display works for ECS-depth apps; RTG true-color display pending Phase 137.
• Networking: Not implemented.
• Audio: Hosted audio.device playback is available, but Paula chip-level DMA timing/mixing remains approximate rather than cycle-exact.

Solution: Specify ROM path:

lxa -r /path/to/lxa.rom myprogram

Or install to system location:

sudo cp build/target/rom/lxa.rom /usr/share/lxa/

Solution: Set system root:

lxa -s . usr/share/lxa/System/Shell

lxa handles case-insensitive Amiga paths automatically. If experiencing issues, enable debug mode:

lxa -d myprogram

See documentation for more troubleshooting tips.

ctest --test-dir build --output-on-failure --timeout 60 -j16

cmake -S . -B build -DCOVERAGE=ON -DCMAKE_BUILD_TYPE=Debug
cmake --build build -j$(nproc)
cmake --build build --target coverage
firefox build/coverage_report/index.html

Contributions welcome! Please:

1. Read doc/developer-guide.md
2. Write tests for new features (target 100% coverage)
3. Follow coding standards in AGENTS.md
4. Update documentation

lxa (Linux Amiga) is an emulation layer that runs AmigaOS programs on Linux without requiring a full Amiga system. Think of it as WINE for Amiga — it translates AmigaOS system calls to Linux equivalents on-the-fly.

The strategic goal is to become a development platform for Amiga software on Linux: productivity apps (Wordsworth, Amiga Writer, PageStream), IDEs (Storm C, BlitzBasic 3), and GUI toolkit applications (MUI, ReAction) should all run and be testable on commodity hardware. Because lxa targets OS-compliant applications only, it can use RTG (Retargetable Graphics) via Picasso96 rather than emulating ECS/AGA chip registers — enabling full true-color displays at any resolution.

How it works:

• Emulates the Motorola 68000 CPU (via Musashi)
• Implements AmigaOS libraries (exec.library, dos.library, graphics.library, intuition.library, etc.)
• Maps Amiga filesystem calls directly to Linux (WINE-like approach)
• Provides preemptive multitasking and message passing
• RTG display via Picasso96 (Picasso96API.library) on SDL2 — no chip-register emulation needed

• No hardware emulation — Direct Linux I/O, no floppy/hard drive emulation
• RTG-first display — Picasso96 for true-color at arbitrary resolution; ECS planar modes supported for legacy apps
• Case-insensitive VFS — Amiga paths work on Linux filesystem
• Native performance — Most operations run at native speed
• Fully preemptive — Timer-driven task switching at 50Hz

See doc/architecture.md for technical details.

MIT License - See LICENSE for details.

We welcome contributions! Priority areas:

• RTG / Picasso96: Picasso96API.library and cybergraphics.library implementation (Phases 137–139)
• GUI toolkits: MUI and ReAction/ClassAct hosting support (Phases 141–142)
• Productivity app coverage: Wordsworth, Amiga Writer, PageStream, Storm C, BlitzBasic 3 drivers
• AmigaOS library completeness: filling gaps in existing exec/dos/graphics/intuition implementations
• Test coverage: new host-side GTest drivers for untested apps
• Command-line tool enhancements

Please read doc/developer-guide.md before contributing.

• Musashi - 68000 CPU emulator by Karl Stenerud
• bebbo/amiga-gcc - m68k AmigaOS cross-compiler
• AROS - Open-source AmigaOS implementation (reference)
• AmigaOS community for documentation and support