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

  <Card title="Architecture" icon="sitemap" href="/architecture/introduction/overview">
    Learn how Monolex works under the hood.
  </Card>
</CardGroup>