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

# Install

> Install OpenCLIs on macOS, Linux, or Windows. One command, PATH automatic.

<Card title="Start with the guided install" icon="rocket" href="https://monolex.ai/openclis/install/">
  Use the short Monolex walkthrough first; return here for platform commands, updates, file layout, and troubleshooting.
</Card>

## Quick Install

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://openclis.com/install.sh | sh
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    Set-ExecutionPolicy Bypass -Scope Process -Force; irm https://openclis.com/install.ps1 | iex
    ```

    The `Set-ExecutionPolicy Bypass -Scope Process` prefix is required because Windows blocks remote scripts by default. `-Scope Process` confines the change to the current PowerShell window — it closes, the policy reverts. This is the same pattern used by Chocolatey, Scoop, oh-my-posh, Volta, and most Windows CLI installers.

    A signed installer (`.exe` + `winget`) is in preparation and will let you skip this prefix entirely.
  </Tab>

  <Tab title="Windows (Git Bash)">
    ```bash theme={null}
    curl -fsSL https://openclis.com/install.sh | sh
    ```
  </Tab>
</Tabs>

PATH is configured automatically. Open a new terminal and run:

```bash theme={null}
openclis
```

***

## What It Does

1. Detects your OS and architecture
2. Downloads the binary from `cdn.openclis.com`
3. Verifies SHA-256 integrity
4. Installs to `~/.openclis/bin/`
5. Adds to your shell PATH automatically

| Shell            | Where PATH is added                   |
| ---------------- | ------------------------------------- |
| zsh              | `~/.zshrc`                            |
| bash             | `~/.bash_profile` or `~/.bashrc`      |
| fish             | `~/.config/fish/conf.d/openclis.fish` |
| Git Bash         | `~/.bashrc`                           |
| PowerShell / cmd | Windows User `Path` registry          |

Re-running the installer is safe — PATH entries are never duplicated.

***

## Supported Platforms

| Platform          | Architecture | Installer                            |
| ----------------- | ------------ | ------------------------------------ |
| macOS ARM (M1–M4) | `aarch64`    | install.sh                           |
| Linux x64         | `x86_64`     | install.sh                           |
| Linux ARM         | `aarch64`    | install.sh                           |
| Windows x64       | `x86_64`     | install.ps1 or install.sh (Git Bash) |

***

## Install Tools

```bash theme={null}
# Search for tools
openclis search "code search"

# Learn a tool before installing
openclis init niia

# Install
openclis install niia
openclis install @github/ripgrep
openclis install @github/fd

# List installed
openclis list
```

### Install niia

```bash theme={null}
openclis install niia
```

See [NIIA → Install](/ai-clis/niia#install) for details on companion tools and AI CLI integration.

***

## Update

```bash theme={null}
# Update all installed tools
openclis update
```

To update openclis itself, re-run the installer:

<Tabs>
  <Tab title="macOS / Linux / Git Bash">
    ```bash theme={null}
    curl -fsSL https://openclis.com/install.sh | sh
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    Set-ExecutionPolicy Bypass -Scope Process -Force; irm https://openclis.com/install.ps1 | iex
    ```
  </Tab>
</Tabs>

***

## Uninstall

```bash theme={null}
rm -rf ~/.openclis
```

Then remove the PATH line from your shell profile:

| Shell      | File to edit                                                                                                              |
| ---------- | ------------------------------------------------------------------------------------------------------------------------- |
| zsh        | `~/.zshrc`                                                                                                                |
| bash       | `~/.bash_profile` or `~/.bashrc`                                                                                          |
| fish       | Delete `~/.config/fish/conf.d/openclis.fish`                                                                              |
| Git Bash   | `~/.bashrc`                                                                                                               |
| PowerShell | `[Environment]::SetEnvironmentVariable("Path", ($env:Path -replace [regex]::Escape("$HOME\.openclis\bin;"), ""), "User")` |

***

## File Layout

```
~/.openclis/
├── bin/              # Binaries (on PATH)
│   ├── openclis
│   ├── niia
│   ├── rg
│   └── ...
├── versions/         # Installed versions
├── state.json        # Install receipts
└── initiate.md       # AI usage guide (auto-generated)
```

***

## Troubleshooting

### `command not found` after install

Open a **new terminal**. Or source manually:

```bash theme={null}
source ~/.zshrc    # zsh
source ~/.bashrc   # bash / Git Bash
```

### macOS: "openclis" is damaged

```bash theme={null}
xattr -d com.apple.quarantine ~/.openclis/bin/openclis
```

### Permission denied

```bash theme={null}
chmod +x ~/.openclis/bin/openclis
```