DOSSim

DOSSim is a browser-based platform where users can run standard DOS commands and generate simple DOS apps/games from natural language prompts, executed via js-dos, with a custom CMD-like interpreter for bidirectional communication.

Features

• DOS-like CLI Environment: Run classic DOS commands like CLS, DIR, etc.
• Generative Capabilities: Create and run simple BASIC programs through natural language prompts
• Real-time Interaction: Bidirectional communication between JavaScript and the DOS environment
• Streaming Response: See code being generated in real-time as if it's being typed

Example Commands

• CLS - Clear the screen
• DIR - List files in the virtual filesystem
• HELP - Show available commands
• MARIO.BAS /no-koopas /play-as-princess - Generate and run a Mario game with specified options

Technologies Used

• js-dos: Emulation of DOS in the browser
• QBasic 4.5: Programming language used for generated programs
• GW-BASIC: Used for the custom CMD interpreter
• Async Generators: Streaming the AI-generated code in real-time

Local Development

1. Clone the repository
2. Open index.html in a web browser

To use the AI code generation feature:

1. Click on the "AI Settings" panel below the DOS window
2. Enable AI with the toggle switch
3. Enter your OpenRouter API key (get one at https://openrouter.ai)
4. Select your preferred model
5. Save settings

You can also run in debug mode which will use a mock implementation instead of making real API calls.

License

See the LICENSE file for details.