microM8 is a comprehensive Apple II emulator with advanced features for both casual users and developers. It provides accurate emulation of Apple II hardware along with modern integration capabilities including MCP (Model Context Protocol) support for AI assistant interaction.

• Full Apple II/II+ emulation
• 6502 CPU emulation with cycle-accurate timing
• Support for disk operations and various disk image formats
• Built-in assembler (asm65xx)
• MCP server integration for AI-powered control and automation
• Cross-platform support (Linux, macOS, Windows)
• Remote interface capabilities
• Debugging and development tools

microm8-clean/
├── GoPath/src/paleotronic.com/
│   ├── octalyzer/        # Main emulator client
│   ├── server/           # Server components
│   ├── core/             # Core emulation logic
│   ├── debugger/         # Debugging tools
│   └── ...
└── ...

• Go programming language (1.16 or later)
• Git
• Standard build tools (gcc, make, etc.)

1. Clone the repository:

git clone <repository-url>
cd microm8-clean

2. Navigate to the octalyzer directory:

cd GoPath/src/paleotronic.com/octalyzer

3. Build the project using the lmake.sh script:

./lmake.sh build

This will create the microM8 executable in the current directory.

The lmake.sh script supports several build targets:

• ./lmake.sh build - Standard build (default)
• ./lmake.sh run - Build and run the emulator
• ./lmake.sh asm - Build the assembler component
• ./lmake.sh remint - Build the remote interface version
• ./lmake.sh nox - Build without X11 dependencies (noxarchaist)
• ./lmake.sh macos - Build for macOS x86_64 (requires xgo)
• ./lmake.sh profile - Build and run with profiling

Note: Build messages about xgo not being found can be safely ignored unless you're cross-compiling for macOS.

After building, you can run the emulator:

./microM8

To enable MCP server for AI integration:

Stdio mode (default):

./microM8 -mcp

SSE mode (for web-based clients):

./microM8 -mcp -mcp-mode sse
./microM8 -mcp -mcp-mode sse -mcp-port 8080

Server:

cd GoPath/src/paleotronic.com/server
go build

Client (Octalyzer):

cd GoPath/src/paleotronic.com/octalyzer
go build

Remote Interface:

cd GoPath/src/paleotronic.com/octalyzer
go build -tags remint

MIT License

[Contribution guidelines to be added]

[Support information to be added]