Skip to content

Installation

CortexPrism edited this page Jun 17, 2026 · 1 revision

Installation

CortexPrism supports Linux, macOS, and Windows. Choose your platform below.

Linux

curl -fsSL https://raw.githubusercontent.com/CortexPrism/cortex/main/install.sh | bash

Requirements: Kernel 4.x+, glibc 2.28+, Git

macOS

curl -fsSL https://raw.githubusercontent.com/CortexPrism/cortex/main/install.sh | bash

Requirements: macOS 11.0 (Big Sur) or later, Git (via xcode-select --install)

Manual Install

git clone --depth 1 https://github.com/CortexPrism/cortex.git ~/.cortex
cd ~/.cortex
deno run --allow-all src/main.ts setup

PATH Setup

The installer creates a cortex wrapper at ~/.deno/bin/cortex. Add to your shell profile:

echo 'export PATH="$HOME/.deno/bin:$PATH"' >> ~/.zshrc

macOS Notes

  • Desktop automation uses osascript and screencapture (built-in)
  • Mouse actions require cliclick: brew install cliclick
  • Docker sandbox requires Docker Desktop

Windows

iwr -Uri https://raw.githubusercontent.com/CortexPrism/cortex/main/install.ps1 -OutFile install.ps1
.\install.ps1

Requirements: Windows 10+, PowerShell 5.1+, Git for Windows

Manual Install

git clone --depth 1 https://github.com/CortexPrism/cortex.git $env:USERPROFILE\.cortex
cd $env:USERPROFILE\.cortex
deno run --allow-all src/main.ts setup

PATH Setup

The Deno installer adds $env:USERPROFILE\.deno\bin to your PATH automatically. Restart your terminal after installation.

Windows Notes

  • Shell execution uses PowerShell by default
  • Desktop automation uses PowerShell + .NET System.Windows.Forms
  • Docker sandbox requires Docker Desktop with WSL2
  • Service installation: cortex daemon install

Pre-compiled Binary

Download the latest binary from the Releases page. All binaries include SHA-256 checksums and optional GPG signatures.

Uninstall

macOS/Linux:

rm -rf ~/.cortex ~/.deno/bin/cortex

Windows:

Remove-Item -Recurse -Force $env:USERPROFILE\.cortex
Remove-Item -Force $env:USERPROFILE\.deno\bin\cortex.exe

Next Steps

Clone this wiki locally