System Requirements
Download
macOS (Apple Silicon)
For Apple Silicon Macs
Recommended
Installation Steps
macOS
- Download the DMG file from monolex.ai
- Open the DMG file
- Drag Monolex to your Applications folder
- Launch Monolex from Applications
Verify Installation
After installation, verify the app is working:Distribution
The public Monolex download is the Base application. It is plugin-free and does not bundle Node.js or GitHub CLI; optional command-line tools and runtimes are installed on demand through OpenCLIs. Licensed plugin features are delivered through the in-app updater when they are available, while keeping the same application and data model. There is no separate lightweight download edition.Configuration
Data Locations
Default Shell
Monolex uses your default shell:- Reads from
$SHELLenvironment variable - Falls back to
/bin/zshon macOS - Falls back to
/bin/bashon Linux
Troubleshooting
App Won’t Launch
- Gatekeeper block: Right-click → Open
- Corrupted download: Re-download the DMG
- Old version conflict: Delete
~/Library/Application Support/Monolex/and retry
Terminal Not Working
High CPU Usage
Usually caused by:- Many terminal tabs open
- Large file being watched
- Rapid file changes
- Close unused tabs
- Add directories to ignore list
- Check watcher configuration
Uninstallation
Complete Removal
Updates
Monolex checks for updates automatically. When a new version is available:- A notification will appear
- Click “Update” to download
- The app will restart with the new version
- Menu → Monolex → Check for Updates
Next Steps
Quickstart
Get started with Monolex in 5 minutes.
Architecture
Learn how Monolex works under the hood.