Documentation

Installation

Download the latest version from GitHub Releases. Choose your platform:

• macOS — .zip for Apple Silicon or Intel. Unzip and drag to Applications.
• Windows — .exe installer or portable version.
• Linux — .AppImage or .deb package.

On first launch, macOS may show a security prompt since Nevermind is distributed outside the App Store. Open System Settings → Privacy & Security and click "Open Anyway."

First run & sign in

Press Alt+Space to open the command palette. Type "Log in to Nevermind" and press Enter. A browser window will open — approve the sign-in, and the app receives a secure token automatically.

Signing in connects your desktop to Nevermind's AI models and enables the AI extension builder. You can also manage API tokens, credits, and your subscription from the profile dashboard.

Once signed in, use Alt+Space anytime to open the palette and connect additional devices from the dashboard.

The command palette

Nevermind is a command palette — a fast, keyboard-driven interface for your desktop. Press Alt+Space to open it anywhere. Type to search, and the palette shows matching commands, extensions, apps, and files.

From the palette you can:

• Run built-in commands — calculator, force quit, web search, and more
• Launch applications — type an app name to open or force quit it
• Use extensions — screenshots, camera, clipboard viewer, and anything you build
• Search files — find recently opened files or browse by name
• Configure shortcuts — assign global hotkeys to commands you use often

Pro tip: Press Cmd+K inside any extension view to see its available actions. Press Cmd+Alt+K to see keyboard shortcuts.

Everyday tools

Launch & quit apps

Open the palette and start typing an app name — Nevermind shows running and installed applications. Press Enter to launch or switch to it.

To force quit a frozen app, type its name and choose "Force Quit" from the action menu, or open "Force Quit Apps" to see all running applications.

Calculator

Open the palette and type a math expression like 42 * 7 or sqrt(144). Nevermind evaluates it inline and shows the result. You can copy the result, continue calculating, or replace the search with the answer.

Beyond arithmetic, it handles scientific functions (sin, cos, log), constants (pi, e), and unit conversions (5km to mi, 100F to C).

Web search

Type a URL like github.com to open it in your default browser, or type a search query and choose "Search the Web" to search via your configured search engine.

Clipboard

The clipboard history tracks recently copied text. Search through your clipboard entries from the palette and paste them with one click.

System controls

Lock your screen, put the computer to sleep, or restart — all from the palette. Type "Lock Screen", "Sleep", or "Restart Computer".

AI builder

The AI builder creates custom extensions from natural language. Open the palette, describe what you want, and Nevermind generates a working TypeScript extension on the spot.

Examples:

• "A screenshot tool that captures a window and shows it in a preview"
• "A camera overlay I can use as a mirror"
• "A grid of my recent images from the Downloads folder"

Each generated extension includes a chat history, so you can iterate — adjust the UI, change behavior, or add permissions without starting over.

Building your own

Extensions are local TypeScript files stored in your Nevermind user data directory. Use the built-in editor (Cmd+K → Edit) to write your own, or open the folder and create a .ts file manually.

The extension API provides:

• ctx.desktop.apps — launch and query applications
• ctx.desktop.files — browse and search local files
• ctx.desktop.shell — run shell commands
• ctx.clipboard — read and write clipboard contents
• ctx.ai — use AI models for text generation and chat
• ctx.camera — capture photos and video frames
• ctx.ocr — extract text from images and screenshots

Extensions declare permissions in their config and are isolated to what they request. For the full API reference, open the extension editor and use the read_extension_api tool.

Built-in extensions (Apps, Calculator, Clipboard, Web Search, System, Settings) live alongside yours and can be inspected as examples in ~/.nevermind/extensions/.

Keyboard shortcuts

Nevermind ships with these default shortcuts:

You can assign custom global shortcuts to any command. Open "Keyboard Shortcuts" from the palette, find the command, and click "Change shortcut" to record a new key combination.

API access

Nevermind provides an OpenAI-compatible chat completions endpoint at https://api.nvm.fyi/api/v1/chat/completions.

Authentication

Create a Personal Access Token (PAT) from your profile page. Pass it as a Bearer header:

Authorization: Bearer nvm_pat_YOUR_TOKEN

Tokens are prefixed with nvm_pat_ and can be revoked individually. Never share a token or commit it to version control.

Example request

curl -sS https://api.nvm.fyi/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer nvm_pat_YOUR_TOKEN" \
  -d '{"model":"nevermind","messages":[{"role":"user","content":"Hello!"}]}'

Models

Requests are routed across a pool of supported AI providers. The model you choose determines the provider path and capabilities. Model availability depends on your plan and the current backend configuration.

Error codes

Account & billing

Manage your subscription, view credit balances, and create API tokens from the profile dashboard. Billing is handled securely by Stripe — Nevermind does not store payment details.

Every account includes free monthly credits. Paid plans add additional credits per billing cycle. See the pricing page for current plans.