> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monolex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Download and install Monolex AI Terminal

Monolex is available for macOS, with Linux and Windows support coming soon.

## System Requirements

| Platform | Minimum | Recommended |
| - | - | - |
| macOS | 11.0 (Big Sur) | 13.0+ (Ventura) |
| Architecture | Apple Silicon | Apple Silicon |
| Memory | 4GB RAM | 8GB RAM |
| Storage | 150MB | 300MB |

## Download

<CardGroup cols={1}>
  <Card title="macOS (Apple Silicon)" icon="apple" href="https://download.monolex.ai/monolex/latest/mac">
    For Apple Silicon Macs
    **Recommended**
  </Card>
</CardGroup>

## Installation Steps

### macOS

1. **Download** the DMG file from [monolex.ai](https://monolex.ai)

2. **Open** the DMG file

3. **Drag** Monolex to your Applications folder

4. **Launch** Monolex from Applications

<Warning>
  On first launch, macOS may show a security warning. Right-click the app and select "Open" to bypass Gatekeeper.
</Warning>

### Verify Installation

After installation, verify the app is working:

```bash theme={null}
# Check if daemons are running
ps aux | grep -E "pty-daemon|niia-watcher"

# Check daemon logs
tail -f /tmp/pty-daemon.log
```

## 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

| 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:

```bash theme={null}
# Set zsh as default
chsh -s /bin/zsh

# Set bash as default
chsh -s /bin/bash
```

## Troubleshooting

### App Won't Launch

1. **Gatekeeper block**: Right-click → Open
2. **Corrupted download**: Re-download the DMG
3. **Old version conflict**: Delete `~/Library/Application Support/Monolex/` and retry

### Terminal Not Working

```bash theme={null}
# 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

```bash theme={null}
# 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:

1. A notification will appear
2. Click "Update" to download
3. The app will restart with the new version

To manually check for updates:

* Menu → Monolex → Check for Updates

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get started with Monolex in 5 minutes.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.