Installation Guide
CyberMind CLI works on Windows and macOS. One command installs everything — AI chat + AI coding assistant. No admin rights needed. Key passed via environment variable — never in shell history.
Does the AI coding assistant need admin rights?
No. The AI coding assistant installs to C:\Users\YourName\.cybermind\ on Windows and /usr/local/bin/ on macOS (requires sudo once for macOS).
How it works: The AI coding assistant runs as your user process. When you run cybermind in your project folder, it has exactly the same file permissions as you do in that terminal session. It can read/write any file you can read/write — nothing more, nothing less.
Get your API key first
One key works for both AI chat and AI coding assistant. Looks like cp_live_xxxxxxxxxxxx
Free account — no credit card required.
Windows Installation
Windows 10 / Windows 11 — PowerShell required
Open PowerShell as Administrator
Press Win + X → click Windows PowerShell (Admin) or Terminal (Admin)
Verify PowerShell version (must be 5.1+):
$PSVersionTable.PSVersionRun the install command
Replace YOUR_KEY with your actual API key from the dashboard:
$env:CYBERMIND_KEY="YOUR_KEY"; (iwr https://cybermindcli1.vercel.app/install.ps1 -UseBasicParsing).Content | iexThe key is passed as an environment variable — it never appears in your shell history or ps aux output.
Verify installation
After install completes, verify it works:
cybermind --versioncybermind --whoamiLaunch AI Coding Assistant
Navigate to your project folder and launch the AI coding assistant:
cd C:\Users\YourName\my-projectcybermind✓ The AI coding assistant will index your project and launch the interactive TUI
⚠️ Windows Troubleshooting
ExecutionPolicy error?
Run this first, then retry the install:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserCommand not found after install?
Close and reopen PowerShell. The PATH update requires a new session.
Windows Defender blocks the download?
Add an exclusion for the CyberMind install directory, or download manually from the install page.
macOS Installation
macOS 12 Monterey or later — Terminal required
Open Terminal
Press ⌘ + Space → type Terminal → Enter. Or use iTerm2 for a better experience.
Run the install command
Replace YOUR_KEY with your API key:
CYBERMIND_KEY=YOUR_KEY curl -sL https://cybermindcli1.vercel.app/install-mac.sh | bashVerify installation
cybermind --versioncybermind --whoamiLaunch AI Coding Assistant
cd ~/my-projectcybermind⚠️ macOS Troubleshooting
"Cannot be opened because the developer cannot be verified"?
Go to System Settings → Privacy & Security → click "Allow Anyway" next to the cybermind binary.
curl not found?
Install Xcode Command Line Tools first:
xcode-select --installCommand not found after install?
Reload your shell config:
source ~/.zshrcWhat to do after installing
Launch AI coding assistant
cybermindOpens the AI coding assistant in your current directory
AI chat (security mode)
cybermind chatInteractive AI chat with security context
Check your plan & key
cybermind --whoamiShows your tier, provider, model, and masked key
Run diagnostics
cybermind doctorChecks your setup and fixes common issues
Security scan mode
cybermind /scan <target>Runs security scan mode
Update to latest version
cybermind updateDownloads and installs the latest release
AI Coding Assistant — First session
Once the AI coding assistant launches, here is what you will see and how to use it:
⚡ CyberMind AI v2.5.0 | Workspace: ~/my-project (1,247 files)
Model: MiniMax M2.5 | Provider: OpenRouter | Mode: Guard
> add JWT authentication to the Express API
◆ AI: Reading project structure...
✓ Found: src/routes/auth.js, src/middleware/
✓ Plan ready — 3 files to edit, 1 to create
[A]pply [S]kip [P]review [E]xplain
Type your task in plain English — the AI reads your codebase and makes targeted edits.
Press A to apply changes, S to skip, P to preview the diff first.
Type / to open the command menu — add files, change mode, undo, compress context.
Press Tab to cycle through edit modes (Guard → AutoEdit → Blueprint → Autopilot).