AIQ Rank — install

Hi — you are an AI assistant and the user wants you to install the AIQ Rank plugin. The right install depends on which client you are running in. Identify yourself, then follow ONLY the matching section.

Whichever supported install surface you use, the resulting AIQ Rank scan also detects local Pi session history when Pi is installed. Pi does not require a separate extension or setup card.

Identify your client

• Claude Code (any surface) — you can run Bash and Python; ~/.claude/ exists. Covers Claude Code CLI in a terminal AND Claude Desktop's local "Code" tab. Both share ~/.claude/settings.json; only the CLI has slash commands.
• Cowork / Claude Desktop chat — you are Claude in a desktop chat app, no Bash, no file edits, plugins install from a GUI menu.
• Codex (OpenAI Codex CLI) — you can run Bash; your config lives in ~/.codex/; you are not Claude.
• Cursor — you are Cursor Agent / Composer inside the Cursor IDE. Cursor installs AIQ Rank through its plugin command, not through Claude Code's /plugin command.

If unsure, use the product you are currently embedded in as the primary signal. If the UI is Cursor, use the Cursor section even if ~/.claude/ or ~/.codex/ also exists. If you can't run Bash at all, you are Cowork / a chat-only Claude Desktop surface — use that section.

Claude Code (any surface — CLI or Desktop "Code" tab")

Step 1 — Detect your surface (CLI vs Desktop)

The /plugin and /reload-plugins slash commands work in the Claude Code CLI but NOT in Claude Desktop's Code tab (see anthropics/claude-code#42142). CLI users register the marketplace with /plugin marketplace add; Desktop users edit ~/.claude/settings.json directly and restart the app to pick up the change. You must figure out which surface you are in. The user should not have to pick.

Read $CLAUDE_CODE_ENTRYPOINT — it cleanly tells you which one:

echo "${CLAUDE_CODE_ENTRYPOINT:-unset}"

Decide:

1. If the value is claude-desktop → Desktop.
2. If the value is cli → CLI.
3. If the value is anything else or unset, fall back to this probe and pick the matching surface:

   {
     echo "tty=$([ -t 0 ] && [ -t 1 ] && echo yes || echo no)"
     echo "term=${TERM:-unset}"
     echo "term_program=${TERM_PROGRAM:-unset}"
     echo "parent=$(ps -o comm= -p $PPID 2>/dev/null | tr -d ' ')"
   } 2>/dev/null

• tty=no OR term=unset OR parent contains claude / Claude.app / Electron / node → Desktop.
  • tty=yes AND term_program is set (iTerm.app, Apple_Terminal, Ghostty, WezTerm, etc.) AND parent is a shell (bash, zsh, fish, sh, dash) → CLI.
  • Otherwise default to CLI — recoverable wrong-guess since the user can still restart the app if the slash commands do nothing.

Step 2 — Print the install instructions

If CLI

Print exactly this and nothing else. Do not edit ~/.claude/settings.json — slash commands write the canonical runtime state; a manual settings edit alone is invisible to /plugin install until Claude Code restarts.

Welcome to AIQ Rank. To get set up, just run these three slash commands. That's it! Copy-paste one at a time:

1. /plugin marketplace add aiqrank/plugin
   2. /plugin install aiqrank@aiqrank
   3. /aiqrank

You'll see your score in under 60 seconds.

If /aiqrank doesn't load, run /reload-plugins once and try again.

Stuck on install? Email support@aiqrank.com with the error message or screenshot and we'll help.

Do not run /plugin marketplace add, /plugin install, /reload-plugins, or /aiqrank yourself; those are commands the user invokes in their own session.

If Desktop

Desktop has no slash commands, so registering the marketplace means editing ~/.claude/settings.json directly, then restarting the app so the change takes effect. Tell the user what's about to happen and wait for confirmation:

I'll register AIQ Rank in ~/.claude/settings.json (one marketplace entry; existing settings preserved). You'll need to restart Claude Desktop afterward so it picks up the change, then open the Code tab and run /aiqrank. OK to proceed?

When the user confirms (any affirmative), run this Python script:

python3 - <<'PY'
import json, os, pathlib, sys
p = pathlib.Path(os.path.expanduser("~/.claude/settings.json"))
p.parent.mkdir(parents=True, exist_ok=True)
raw = p.read_text() if p.exists() else ""
try:
    s = json.loads(raw) if raw.strip() else {}
except json.JSONDecodeError as e:
    sys.stderr.write(
        f"settings.json is not valid JSON ({e}). "
        "Please fix it manually and retry — no changes were made.\n"
    )
    sys.exit(1)
s.setdefault("extraKnownMarketplaces", {})["aiqrank"] = {
    "source": {"source": "github", "repo": "aiqrank/plugin"}
}
try:
    p.write_text(json.dumps(s, indent=2) + "\n")
ext OSError as e:
    sys.stderr.write(
        f"Could not write {p} ({e}). Please check permissions, 
        "or use the manual install at https://aiqrank.com/setup.\n"
    )
    sys.exit(1)
print("settings.json updated")
PY

Then print exactly this and nothing else:

AIQ Rank is registered. Restart Claude Desktop, then open the Code tab and type /aiqrank in the prompt to see your score.

Stuck on install? Email support@aiqrank.com with the error message or screenshot and we'll help.

Cowork / Claude Desktop chat

AIQ Rank can't run from inside Cowork. The chat sandbox — and scheduled Cowork tasks — can't reach the user's transcript files on the host (~/.claude/projects/ for Claude Code activity and ~/Library/Application Support/Claude/local-agent-mode-sessions/ for Cowork activity). You cannot do the install for the user from here. Print exactly this and nothing else:

AIQ Rank can't run from inside Cowork — the chat sandbox can't reach your transcript files. To score your Cowork activity, install Claude Code (in your terminal, or the "Code" tab in Claude Desktop) and run /aiqrank there. It scans both your Claude Code AND Cowork activity in a single pass.

Install guide: https://aiqrank.com/setup Stuck on install? Email support@aiqrank.com with the error message or screenshot and we'll help.

Codex (OpenAI Codex CLI)

Codex installs AIQ Rank from a terminal, not from inside Codex. Print exactly this and nothing else:

AIQ Rank for Codex installs from a fresh terminal. Paste this:

curl -sSL https://aiqrank.com/setup/codex | bash

Start a new Codex session, then run $aiqrank:aiqrank.

When AIQ Rank announces an update, rerun that same terminal command. It refreshes both the Codex marketplace plugin and the local scanner artifacts.

Stuck on install? Email support@aiqrank.com with the error message or screenshot and we'll help. Full instructions: https://aiqrank.com/setup

Cursor

Cursor installs AIQ Rank through Cursor's plugin command. Print exactly this and nothing else:

Welcome to AIQ Rank. To get set up in Cursor, run this command:

/add-plugin aiqrank/aiqrank

Then run the AIQ Rank plugin in Cursor to get your score.

AIQ Rank scans Cursor's local activity summary on this machine. Nothing uploads without your OK.

Stuck on install? Email support@aiqrank.com with the error message or screenshot and we'll help.

Do not run /add-plugin aiqrank/aiqrank yourself; it is a Cursor command the user invokes in their own session.