Update documentation to reflect current architecture

- Simplify quick-start.md installation (remove non-existent build steps)
- Fix GitHub URL to UCSBarchlab/MapacheSPIM
- Remove CMake/C++ prerequisites (not needed for pip install)
- Update Sail references to Unicorn Engine throughout
- Fix command name from ./mapachespim_console to mapachespim
- Update Makefile run targets to use mapachespim

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: timsherwood

docs/user/console-guide.md

@@ -1,15 +1,15 @@
 # MapacheSPIM Interactive Console Guide
 
-SPIM-like interactive console for RISC-V programs using the Sail formal specification.
+SPIM-like interactive console for RISC-V programs using the Unicorn Engine.
 
 ## Quick Start
 
 ```bash
 # Launch interactive console
-./mapachespim_console
+mapachespim
 
 # Or load a program on startup
-./mapachespim_console examples/riscv/fibonacci/fibonacci
+mapachespim examples/riscv/fibonacci/fibonacci
 ```
 
 ## Basic Commands
@@ -144,8 +144,7 @@ SPIM-like interactive console for RISC-V programs using the Sail formal specific
 ## Example Session
 
 ```
-$ ./mapachespim_console
-Sail RISC-V simulator initialized.
+$ mapachespim
 Welcome to MapacheSPIM. Type help or ? to list commands.
 
 (mapachespim) load examples/riscv/fibonacci/fibonacci
@@ -203,13 +202,13 @@ The console shows both numeric (x0-x31) and ABI names:
 
 ```bash
 # Launch console
-./mapachespim_console
+mapachespim
 
 # Load file on startup
-./mapachespim_console examples/riscv/fibonacci/fibonacci
+mapachespim examples/riscv/fibonacci/fibonacci
 
 # Quiet mode (less verbose)
-./mapachespim_console -q examples/riscv/fibonacci/fibonacci
+mapachespim -q examples/riscv/fibonacci/fibonacci
 ```
 
 ## Keyboard Shortcuts
@@ -275,16 +274,15 @@ The `-g` flag adds DWARF debug information that maps machine addresses to source
 
 MapacheSPIM is similar to SPIM but has key differences:
 
-1. **RISC-V instead of MIPS**: Uses RISC-V ISA with Sail formal spec
+1. **RISC-V instead of MIPS**: Uses RISC-V ISA via Unicorn Engine
 2. **ELF files**: Loads compiled ELF binaries (not assembly source)
-3. **Formal specification**: Uses Sail RISC-V model (not custom simulator)
-4. **64-bit**: Full RV64I support by default
-5. **Source display**: Optional via `list` command (requires `-g` flag)
+3. **64-bit**: Full RV64I support by default
+4. **Source display**: Optional via `list` command (requires `-g` flag)
 
 ## Troubleshooting
 
 **Console won't start:**
-- Make sure the C library is built: `cd lib/build && cmake .. && make`
+- Make sure you've installed the package: `pip install -e .`
 - Check Python path includes mapachespim package
 
 **Can't load ELF file:**

docs/user/quick-start.md

@@ -7,8 +7,6 @@ Get started with MapacheSPIM in 5 minutes. This guide will help you install the
 You'll need:
 - macOS or Linux (Windows via WSL)
 - Python 3.8+
-- CMake 3.10+
-- C++ compiler (GCC or Clang)
 
 Check your Python version:
 ```bash
@@ -17,36 +15,11 @@ python3 --version  # Should be 3.8 or higher
 
 ## Installation
 
-### Option 1: Quick Install (Recommended)
-
 ```bash
 # Clone the repository
-git clone --recursive https://github.com/your-org/MapacheSPIM.git
-cd MapacheSPIM
-
-# One-command setup (if available)
-./scripts/setup.sh
-```
-
-### Option 2: Manual Install
-
-```bash
-# Clone with submodules
-git clone --recursive https://github.com/your-org/MapacheSPIM.git
+git clone https://github.com/UCSBarchlab/MapacheSPIM.git
 cd MapacheSPIM
 
-# Build Sail RISC-V backend
-cd backends/riscv/sail-riscv
-./build_simulators.sh
-cd ../../..
-
-# Build C library
-cd lib
-mkdir -p build && cd build
-cmake ..
-make
-cd ../..
-
 # Create virtual environment (recommended)
 python3 -m venv venv
 source venv/bin/activate
@@ -267,11 +240,11 @@ Now that you've run your first program:
 
 If the console doesn't start, try:
 ```bash
-# Run from Python package
-python3 -m mapachespim.console
+# Make sure your virtual environment is activated
+source venv/bin/activate
 
-# Or use the script directly
-./mapachespim_console
+# Or run from Python package
+python3 -m mapachespim.console
 ```
 
 ### Import Error
@@ -281,30 +254,11 @@ Make sure you installed the Python package:
 pip3 install -e .
 ```
 
-### Build Errors
-
-Check you have all prerequisites:
-```bash
-python3 --version  # 3.8+
-cmake --version    # 3.10+
-gcc --version      # Any recent version
-```
-
-### Library Not Found
-
-Build the C library first:
-```bash
-cd lib/build
-cmake ..
-make
-cd ../..
-```
-
 ### Still Stuck?
 
 - Check the [full console guide](console-guide.md)
 - Look at [example programs](../../examples/README.md)
-- Open an issue on GitHub
+- Open an issue on [GitHub](https://github.com/UCSBarchlab/MapacheSPIM/issues)
 
 ## What's Next?
 

examples/riscv/Makefile

@@ -2,12 +2,11 @@
 # Makefile for RISC-V Assembly Examples
 # ============================================================================
 #
-# This Makefile builds RISC-V assembly programs for execution on the Sail
-# RISC-V emulator.
+# This Makefile builds RISC-V assembly programs for execution with MapacheSPIM.
 #
 # Prerequisites:
 #   - RISC-V GNU toolchain (riscv64-unknown-elf-*)
-#   - Sail RISC-V emulator
+#   - MapacheSPIM (pip install -e . from repo root)
 #
 # Usage:
 #   make                 # Build all examples
@@ -36,10 +35,6 @@ ASFLAGS = -march=rv64g -mabi=lp64
 # Linker flags
 LDFLAGS = -T linker.ld
 
-# Sail emulator path
-# Adjust this path to your Sail RISC-V simulator location
-SAIL_SIM = ../sail-riscv/build/c_emulator/sail_riscv_sim
-
 # ============================================================================
 # Targets
 # ============================================================================
@@ -109,29 +104,20 @@ guess_game/guess_game.o: guess_game/guess_game.s
 	$(AS) $(ASFLAGS) -o $@ $<
 
 # ============================================================================
-# Run targets - execute programs with trace enabled
+# Run targets - execute programs with MapacheSPIM
 # ============================================================================
 
 run-matrix: matrix_multiply/matrix_mult
 	@echo "=========================================="
 	@echo "Running Matrix Multiplication"
 	@echo "=========================================="
-	$(SAIL_SIM) --trace-instr $<
+	mapachespim -x $<
 
 run-fibonacci: fibonacci/fibonacci
 	@echo "=========================================="
 	@echo "Running Fibonacci Calculator"
 	@echo "=========================================="
-	$(SAIL_SIM) --trace-instr $<
-
-# Run with memory trace to see data accesses
-run-matrix-mem: matrix_multiply/matrix_mult
-	@echo "Running Matrix Multiplication with memory trace..."
-	$(SAIL_SIM) --trace-instr --trace-mem $<
-
-run-fibonacci-mem: fibonacci/fibonacci
-	@echo "Running Fibonacci with memory trace..."
-	$(SAIL_SIM) --trace-instr --trace-mem $<
+	mapachespim -x $<
 
 # ============================================================================
 # Utility targets
@@ -165,10 +151,6 @@ check-tools:
 	@which $(AS) > /dev/null || (echo "ERROR: $(AS) not found. Please install RISC-V toolchain."; exit 1)
 	@which $(LD) > /dev/null || (echo "ERROR: $(LD) not found. Please install RISC-V toolchain."; exit 1)
 	@echo "RISC-V toolchain found: $(shell $(AS) --version | head -1)"
-	@echo "Checking for Sail emulator..."
-	@test -f $(SAIL_SIM) || (echo "ERROR: Sail emulator not found at $(SAIL_SIM)"; exit 1)
-	@echo "Sail emulator found: $(SAIL_SIM)"
 	@echo "All tools ready!"
 
-.PHONY: all clean run-matrix run-fibonacci run-matrix-mem run-fibonacci-mem \
-        dis-matrix dis-fibonacci check-tools
+.PHONY: all clean run-matrix run-fibonacci dis-matrix dis-fibonacci check-tools