Quickstart Guide

Welcome to the M0X Ecosystem. M0X is an AI-native developer suite comprising two specialized desktop environments:

• M0X CoderX: A local AI Developer Studio & Agentic Workspace built on Tauri and Next.js.
• M0X IDE: An AI-native desktop code editor fork built on the VS Code engine.

---

🌌 M0X CoderX (AI Developer Studio)

M0X CoderX is a premium local developer studio that merges a high-performance editor workspace with a powerful, stateful AI coding agent loop.

📦 Installation

1. Go to the Download Page on the M0X website.
2. Select your architecture (64-bit or 32-bit) and click Download for Windows to fetch the standalone installer (.exe). (macOS and Linux versions are coming soon).
3. Open the downloaded installer file and follow the on-screen instructions to complete the installation.

⚙️ Initial Configuration

1. Launch the M0X CoderX application from your Start Menu or Desktop.
2. Click the Settings Gear icon in the bottom-left corner of the sidebar navigation.
3. Input your API keys for your preferred LLM providers (e.g. Anthropic Claude, OpenAI GPT, DeepSeek, or custom secure endpoints).
4. Click Save Settings to enable AI model interactions.

⚡ How to Use

1. Open a Project Workspace

• On the welcome screen, click Open Folder and select your project's root folder.
• M0X CoderX will instantly scan and index your codebase. Build output folders and package files (node_modules, target, dist, .git) are automatically excluded from indexing to keep memory footprint and lookup times minimal.

2. Layout Overview

• Left Sidebar (File Explorer): Browse and manage your project folders and files. Click any file to open it in a tab.
• Center Panel (Monaco Editor): A robust multi-tab editor for writing code, supporting standard VS Code hotkeys and auto-completion.
• Right Panel (AI Agent Chat): Your workspace companion where you chat with the model, view reasoning streams, and approve file edits.
• Bottom Panel (PTY Terminal): A fully integrated terminal shell (Powershell/CMD on Windows, Zsh/Bash on macOS/Linux) for compiling, running, and testing code.

3. Choose Your AI Mode

Before submitting a prompt, select your preferred interaction profile:

• ASK: The AI has read-only access. It can explain code and answer questions but cannot edit files or run shell commands.
• EDIT: The AI can write code and run commands, but must pause and request manual confirmation before every action.
• AGENT: The AI works autonomously to solve complex tasks. It executes consecutive tool calls automatically up to a set safety limit (default: 25 steps).

4. Run an AI Task

• Type an instruction in the Chat Sidebar input box, for example:

  Build a new router inside routes/users.js to handle user logins and add a test script.

• Press Submit (or hit Enter) to start the agent loop.

5. Reviewing and Approving Edits

In EDIT mode, the agent presents its tool calls inside the chat feed for your feedback:

• Review Code Diffs: CoderX displays a Visual Diff Card showing a side-by-side comparison of green additions and red deletions.
• Review Shell Commands: The exact terminal script is displayed before execution.
• Select Action:
  • Approve (Checkmark): Applies the code changes / runs the terminal script and resumes the agent loop.
  • Reject (Cross): Discards the changes and halts the loop.
  • Feedback Input: Type comments (e.g., "Use import instead of require on line 2") and click submit. The agent will rewrite the changes and present an updated diff card for your approval.

---

🚀 M0X IDE (AI-Native Code Editor)

M0X IDE is a powerful desktop code editor built on top of the robust VS Code engine. It integrates advanced LLM capabilities directly into your development workflow, providing you with a pair programmer that truly understands your codebase.

📦 Installation & Setup

1. Download and Install

• Go to the Download Page on the M0X website.
• Click Download for Windows to fetch the standalone installer (.exe). (macOS and Linux support is coming soon).
• Run the installer wizard to install M0X IDE as your primary desktop editor.

2. Migration

• On first launch, M0X IDE prompts you to import your settings, extensions, themes, and keybindings from VS Code or Cursor with a single click.

⚡ How to Use

1. Quick Edit (Ctrl+K / Cmd+K)

• Highlight any block of code in your editor.
• Press Ctrl+K (or Cmd+K on Mac) to open the inline edit prompt.
• Type your instruction, e.g. "Add error handling to this method" or "Refactor this to be asynchronous", and hit Enter.
• Review the inline green/red diff stream.
• Press Ctrl+Alt+Shift+Enter (or Ctrl+Option+Enter on Mac) to accept, or Ctrl+Alt+Shift+Backspace (or Ctrl+Option+Backspace on Mac) to reject.

2. Intelligent Chat (Ctrl+L / Cmd+L)

• Press Ctrl+L (or Cmd+L on Mac) to focus the AI sidebar chat.
• Ask questions about your project, explain complex files, or plan refactoring steps.
• The chat automatically references your active files, folders, and terminal context.

3. Autocomplete (Ghost Text)

• As you type code, M0X IDE automatically suggests context-aware inline code completions using Fill-In-the-Middle (FIM) technology.
• Press Tab to accept the gray ghost text suggestions.

4. Agentic Tools & MCP (Model Context Protocol)

• Empower the AI to perform file operations (create, edit, delete) and execute terminal commands on your behalf.
• Connect M0X IDE to external data sources and custom local tools using Model Context Protocol (MCP) servers.
• Configure granular permissions in the settings panel to control auto-approval policies.

5. Discord Bot Integration

• Connect your IDE to Discord to run it as a bot. You can control your editor directly from your server channels.
• Features per-channel memory (stored in .m0x/discord-db), smart routing (routes casual chats directly, while active coding tasks are handed off to the AI Agent), and dynamic model switching (e.g., to claude-3.5-sonnet) with security verification.