# emu8086web

> Modern browser-based 8086 microprocessor assembler and step debugger.

## Summary

emu8086web is an open-source web IDE for writing, assembling, and debugging Intel 8086 assembly (MASM-style). It runs entirely in the browser with no install — a modernization of classic emu8086 for all platforms.

## Key features

- Interpretive 8086 assembler and CPU emulator
- Step / run debugger with breakpoints, registers, flags, memory, and stack views
- DOS INT 21h and BIOS INT 10h console I/O
- Multi-file workspace with named save
- Time-limited shareable program links (`/s/{code}`, 1/3/7 day expiry)
- Light and dark themes

## Primary URLs

- Product (IDE): https://emu-8086-web.vercel.app/
- Author portfolio: https://nafiskabbo.vercel.app/
- Author: Nafis Islam Kabbo (https://github.com/nafiskabbo)
- Source repository: https://github.com/nafiskabbo/emu_8086_web

The application root `/` opens the IDE directly. Agents may request `Accept: text/markdown` on `/` for a concise markdown summary.

## Discovery

- `/llms.txt` — LLM context
- `/sitemap.xml` — sitemap
- `/robots.txt` — crawl rules + Content-Signal
- `/.well-known/api-catalog` — API catalog (RFC 9727)
- `/.well-known/agent-skills/index.json` — agent skills index
- `/api/health` — health check
- `POST /api/share` · `GET /api/share/{code}` — anonymous share API

## Documentation

- README.md — what it is, features, how to run it
- docs/installation.md — web and macOS app setup, self-hosting, troubleshooting
- docs/emulator.md — instruction and interrupt matrix
- docs/corpus-coverage.md — conformance results against a third-party corpus
- docs/thanks.md — the projects this one leans on, with licences
- project.md — product vision and roadmap
- CONTRIBUTING.md — how to contribute

## Author

Developed by Nafis Islam Kabbo.

## Version

See package.json / lib/version.ts (semver).