Installation
Monolex is available for macOS, with Linux and Windows support coming soon.
System Requirements
| Platform | Minimum | Recommended |
|---|
| macOS | 10.13 (High Sierra) | 13.0+ (Ventura) |
| Architecture | Apple Silicon or Intel | Apple Silicon |
| Memory | 4GB RAM | 8GB RAM |
| Storage | 150MB | 300MB |
Download
Installation Steps
macOS
-
Download the DMG file from monolex.ai
-
Open the DMG file
-
Drag Monolex to your Applications folder
-
Launch Monolex from Applications
On first launch, macOS may show a security warning. Right-click the app and select “Open” to bypass Gatekeeper.
Verify Installation
After installation, verify the app is working:
# Check if daemons are running
ps aux | grep -E "pty-daemon|niia-watcher"
# Check daemon logs
tail -f /tmp/pty-daemon.log
Build Types
Monolex offers two build variants:
Regular Build
- Includes bundled Node.js runtime
- ~200MB download
- Works standalone
- Recommended for most users
Core Build
- No bundled Node.js
- ~50MB download
- Requires system Node.js
- For developers with Node.js installed
Configuration
Data Locations
| Data | Path |
|---|
| Application Support | ~/Library/Application Support/Monolex/ |
| Databases | ~/Library/Application Support/Monolex/protocols/niia/database/ |
| Logs | /tmp/pty-daemon.log, /tmp/niia-watcher.log |
| Sockets | /tmp/monolex-pty/ |
Default Shell
Monolex uses your default shell:
- Reads from
$SHELL environment variable
- Falls back to
/bin/zsh on macOS
- Falls back to
/bin/bash on Linux
To change your default shell:
# Set zsh as default
chsh -s /bin/zsh
# Set bash as default
chsh -s /bin/bash
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
# Kill existing daemon processes
pkill -f pty-daemon-rust
# Clean socket files
rm -rf /tmp/monolex-pty/
# Restart Monolex
High CPU Usage
Usually caused by:
- Many terminal tabs open
- Large file being watched
- Rapid file changes
Solutions:
- Close unused tabs
- Add directories to ignore list
- Check watcher configuration
Uninstallation
Complete Removal
# 1. Quit Monolex
# 2. Remove application
rm -rf /Applications/Monolex.app
# 3. Remove data
rm -rf ~/Library/Application\ Support/Monolex/
# 4. Remove logs and sockets
rm -rf /tmp/monolex-pty/
rm -f /tmp/pty-daemon.log
rm -f /tmp/niia-watcher.log
# 5. Kill any remaining processes
pkill -f Monolex
pkill -f pty-daemon-rust
pkill -f niia-watcher
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
To manually check for updates:
- Menu → Monolex → Check for Updates
Next Steps
