Install

Start with the guided install

Use the short Monolex walkthrough first; return here for platform commands, updates, file layout, and troubleshooting.

Quick Install

macOS / Linux
Windows (PowerShell)
Windows (Git Bash)

curl -fsSL https://openclis.com/install.sh | sh

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.

curl -fsSL https://openclis.com/install.sh | sh

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

openclis

What It Does

Detects your OS and architecture
Downloads the binary from cdn.openclis.com
Verifies SHA-256 integrity
Installs to ~/.openclis/bin/
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

# 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

openclis install niia

See NIIA → Install for details on companion tools and AI CLI integration.

Update

# Update all installed tools
openclis update

To update openclis itself, re-run the installer:

macOS / Linux / Git Bash
Windows (PowerShell)

curl -fsSL https://openclis.com/install.sh | sh

Set-ExecutionPolicy Bypass -Scope Process -Force; irm https://openclis.com/install.ps1 | iex

Uninstall

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:

source ~/.zshrc    # zsh
source ~/.bashrc   # bash / Git Bash

macOS: “openclis” is damaged

xattr -d com.apple.quarantine ~/.openclis/bin/openclis

Permission denied

chmod +x ~/.openclis/bin/openclis

Get Started

Articles

So Anthropic

User Guide

Philosophy

Applied Philosophy

Architecture

Gestalt Color

Transparency

Terminal Core

Features

VariableMD

Research

CodexMono

OpenCLIs

vpncli

MonoSurf

AI-CLIs

Start with the guided install

Quick Install

What It Does

Supported Platforms

Install Tools

Install niia

Update

Uninstall

File Layout

Troubleshooting

`command not found` after install

macOS: “openclis” is damaged

Permission denied

Start with the guided install

​Quick Install

​What It Does

​Supported Platforms

​Install Tools

​Install niia

​Update

​Uninstall

​File Layout

​Troubleshooting

​command not found after install

​macOS: “openclis” is damaged

​Permission denied

Quick Install

What It Does

Supported Platforms

Install Tools

Install niia

Update

Uninstall

File Layout

Troubleshooting

`command not found` after install

macOS: “openclis” is damaged

Permission denied