higherMark CLI

A terminal interface to higherMark AI, Cerebras 3,000 tok/s, GPT-4o, Claude, Gemini, Grok, and 400+ OpenRouter models. Works in your Mac terminal, Cursor, iTerm2, or Warp.

Installation

  1. 1

    Run the one-line installer

    Downloads a standalone binary directly, no Node.js, no npm, no repo clone needed.

    curl -fsSL https://highermark.xyz/install.sh | bash
  2. 2

    Verify installation

    highermark /version

    You should see higherMark CLI v0.1.1.

How it works: The installer detects your platform (macOS arm64, macOS x64, Linux x64), downloads a self-contained binary from Vercel CDN, and places it in /usr/local/bin. No runtime dependency required.
Already installed? Run highermark /update inside any session to get the latest version, or re-run the curl command above.

Quick start

Open your terminal and type highermark to launch an interactive REPL chat session against Cerebras (3,000 tok/s by default).

$ highermark
  higherMark  AI terminal
  ──────────────────────────────
  Model   llama-3.3-70b
  API     https://higher-mark-june-july-prod.vercel.app
  ──────────────────────────────

⚡ llama-3.3-70b › what is the BRL/USD rate today?

Pass a message directly for one-shot output (great for scripting):

$ highermark "explain quantum entanglement in one paragraph"

Model selection

Specify a model by name after the command. Aliases resolve to full model IDs automatically.

# Use Grok
highermark grok

# Use Claude
highermark claude

# Use GPT-4o
highermark gpt

# One-shot with a model
highermark grok "who won the 2026 World Cup?"

# Switch mid-session with /model
⚡ llama-3.3-70b › /model deepseek
✓ Switched to deepseek/deepseek-r1
AliasResolves toVia
cerebrasllama-3.3-70b⚡ Cerebras, 3,000 tok/s
llamallama-3.3-70b⚡ Cerebras, 3,000 tok/s
grokx-ai/grok-betaOpenRouter
grok-2x-ai/grok-2-1212OpenRouter
gpt / gpt4openai/gpt-4oOpenRouter
claudeanthropic/claude-3.5-sonnetOpenRouter
geminigoogle/gemini-2.0-flash-001OpenRouter
deepseekdeepseek/deepseek-r1OpenRouter
mixtralmistralai/mixtral-8x7b-instructOpenRouter
qwenqwen/qwen-2.5-72b-instructOpenRouter
phimicrosoft/phi-4OpenRouter

List all models live from OpenRouter with /models, this fetches the full catalogue in real time.

⚡ llama-3.3-70b › /models

Chat commands

CommandDescription
/clearClear conversation history and start fresh
/historyPrint the full conversation in JSON
/copyCopy the last AI reply to your clipboard (macOS: pbcopy)
/modelsFetch and list all OpenRouter models (live, with pricing)
/model <name>Switch the active model mid-session
/splitTips for split-terminal workflow in Cursor / iTerm2
/docsOpen these docs in your browser
/versionShow CLI version
/helpShow all commands inline
/exitQuit (also Ctrl+C)

Usage & credits

CommandDescription
/usageShow total tokens burned, user count, pool balance
/creditsShow your credit balance in USD and sats
/configShow active API base and model
/setapi <url>Override the API base (e.g. http://localhost:4000 for local dev)
Tip: Run /usage regularly to monitor how many tokens you're spending. OpenRouter models count against the shared pool, Cerebras (llama-3.3-70b) is the fastest and most cost-effective default.

Config file

Settings are stored at ~/.highermark/config.json. You can edit it directly:

{
  "apiBase": "https://higher-mark-june-july-prod.vercel.app"
}

Set a custom API (e.g. local dev server) with /setapi http://localhost:4000.

Cursor integration

higherMark CLI works natively in the Cursor integrated terminal. Open a terminal in Cursor with Ctrl+` (backtick) and run highermark.

Using the AI terminal alongside the Cursor editor

The CLI uses higherMark's shared pool (Cerebras + OpenRouter keys), not your Cursor subscription. This means AI usage in highermark doesn't count against your Cursor Pro token limit.

Why this matters: Cursor Pro gives you a monthly token allowance for Composer, Chat, and Tab. Running highermark in a separate terminal pane uses the higherMark pool instead, you can run long research tasks or heavy inference without burning your Cursor allocation.

Split terminals

Run higherMark AI in a dedicated split pane while keeping your editor and Cursor AI in view.

Cursor

# Open terminal: Ctrl+` (backtick)
# Split vertically: drag the terminal panel divider
# Or use the terminal split icon in the top-right of the terminal panel
highermark grok

iTerm2

# Split pane vertically
⌘+D

# Split pane horizontally
⌘+Shift+D

# Navigate panes
⌘+[ and ⌘+]

Warp

# Click the split icon (+) on any pane header
# Or use the command palette: ⌘+P → "Split right"
highermark deepseek

macOS Terminal.app

# New tab: ⌘+T
# Split view (macOS 10.11+): View → Show Split View

Piping & scripts

higherMark CLI auto-detects when stdin is piped and produces clean output (no ANSI colors, no prompts).

# Summarize a file
cat README.md | highermark "summarize this in 3 bullets"

# Review code with a specific model
cat src/app.js | highermark claude "find potential bugs"

# Pipe to pbcopy on macOS
highermark "write a commit message for: added CLI tool" | pbcopy

# Use in a shell script
SUMMARY=$(highermark "summarize: $(cat notes.txt)")
echo "$SUMMARY" >> weekly-digest.md

Available models

The /models command fetches this list live from OpenRouter. Below is a static reference of commonly used models.

⚡ Cerebras (fast inference, default)

Model IDContextSpeed
llama-3.3-70b128k3,000 tok/s
llama-3.1-70b128k2,500 tok/s
llama-3.1-8b128k4,500 tok/s

OpenRouter models

AliasFull IDContext
grokx-ai/grok-beta131k
grok-2x-ai/grok-2-1212131k
gpt / gpt4openai/gpt-4o128k
claudeanthropic/claude-3.5-sonnet200k
geminigoogle/gemini-2.0-flash-0011M
deepseekdeepseek/deepseek-r164k
mixtralmistralai/mixtral-8x7b-instruct32k
qwenqwen/qwen-2.5-72b-instruct131k
phimicrosoft/phi-416k

Run /models in the REPL to see all 400+ models with live pricing from OpenRouter.