CHROME / BRAVE / ARC / EDGE BATCH LIBRARY RENAME ZERO TELEMETRY

STOP SCROLLING THROUGH TRUNCATED PROMPTS.

Q: Does this change Perplexity.ai's fonts, theme, or page layout?

No. Perplexity's website layout, fonts, and CSS remain 100% untouched. Only the extension's own toolbar popup, settings page, and isolated Shadow-DOM bottom-right status toast use the retro pixel HUD theme—and the toast can be disabled anytime with one click.

Q: Where is my LLM API key stored, and can websites read it?

Your API key is stored locally on your device in chrome.storage.local and read exclusively inside the extension's background MV3 Service Worker (src/background/service-worker.js). Neither perplexity.ai nor content scripts nor even the popup DOM ever read back the raw key string. Zero developer servers or analytics exist.

Q: Can I use it completely free without an API key?

Yes! Out of the box with no API key saved, Auto-Rename uses its built-in offline keyword heuristic (heuristicTitle()) to generate clean 3–7 word titles locally with zero network requests. You can also use free-tier keys from Groq, Google AI Studio (Gemini), OpenRouter :free models, or a local Ollama server.

Q: Will it overwrite titles I rename manually or on follow-up questions?

Never. Follow-up messages and related-query clicks are skipped automatically via last_backend_uuid and is_related_query. And if you manually rename a thread in Perplexity's sidebar, the extension detects that request and locks out auto-renaming for that thread permanently.

Q: Can I batch-rename old chats in my Perplexity Library or regenerate a title?

Yes! Open the toolbar popup or Settings page to Rename or Regenerate the currently open chat on demand, or run Batch Rename Library across the Past 50 / 20 Chats, Last 20 / 30 Days, or All Library Chats with live progress and instant cancellation.

Auto-Rename for Perplexity automatically titles every new perplexity.ai thread into a scannable 3–7 word title, lets you rename or ↻ regenerate the currently open chat on demand, and batch-renames your Perplexity Library (past 50 chats, last 20 or 30 days, or all chats)—without altering Perplexity’s page styles.

⬇ DOWNLOAD V0.2.0 (.ZIP) 60-SECOND INSTALL → HOW IT WORKS

3–7

Words per title

10 + 1

LLMs + Offline mode

0 KB

Author telemetry

64/64

Automated tests

WATCHING STREAM_

Answer streaming — will auto-rename when complete.

POST /rest/sse/perplexity_ask → Response.body.tee() SSE STREAMING

Why This Exists

YOUR SIDEBAR, BEFORE & AFTER

Perplexity names every thread after the raw opening words of your prompt—filling your Library with conversational filler and pasted stack traces. Auto-Rename fixes that automatically after the first answer completes.

WITHOUT AUTO-RENAME

TRUNCATED PROMPTS

Hey can you explain how solid-state batteries differ…

Traceback (most recent call last): File "/app/main.py"…

Can you compare zk-rollups vs optimistic rollups spec…

Please summarize recent 2026 papers on off-target eff…

WITH AUTO-RENAME

CRISP 3–7 WORDS

Solid-State vs Liquid Lithium Electrolytes LLM

FastAPI Async SQLAlchemy Session Leak LLM

Zero-Knowledge Rollup Proof Batching LLM

[Research] CRISPR Prime Editing Off-Target PREFIX

FIRST TURN ONLY

Inspects last_backend_uuid and is_related_query so follow-up questions never overwrite an existing thread’s title.

RESPECTS MANUAL EDITS

Detects manual sidebar renames via a private Symbol tag and permanently locks out auto-renaming for that context_uuid.

REGEX RULES & PREFIXES

Skip throwaway lookups (^define\b, ^translate\b) with zero tokens spent, or prepend project tags like [Research].

ZERO PAGE RESTYLING

Perplexity’s own fonts, colors, and React DOM stay 100% untouched. The pixel HUD lives in an isolated ShadowRoot and unmounts when idle.

Real Extension UI

RETRO PIXEL HUD. ZERO BLOAT.

Bundled offline with SIL Open Font License fonts (Silkscreen pixel headers/badges paired with crisp Inter & JetBrains Mono)—giving the extension’s own toaster, popup, and settings a tactile pixel HUD aesthetic while leaving Perplexity’s website completely untouched.

WHILE STREAMING FIRST ANSWER — WATCHING STREAM_ + 2×2 PIXEL MATRIX SPINNER

Watching stream pixel HUD toast on Perplexity.ai

STREAM COMPLETE & HTTP 204 SAVED — ✓ THREAD RENAMED CONFIRMATION

Thread renamed confirmation pixel HUD toast on Perplexity.ai

SHADOW-DOM HUD TOASTER

Subtle bottom-right status HUD on perplexity.ai—easy to turn off anytime with a single toggle in the toolbar popup.

ISOLATED SHADOW ROOT Mounted inside #ppx-autorename-toast Shadow DOM so zero CSS rules ever collide with Perplexity’s styles.

UNMOUNTED WHEN IDLE Appears only during a brand-new thread’s first stream, auto-dismisses cleanly after confirming the new title, and stays completely absent on follow-up turns.

INLINE ↻ REGEN & BATCH PROGRESS Click ↻ REGEN right on the toast to generate a fresh alternative title, or monitor live progress and stop a Batch Library Rename anytime.

ONE-CLICK TOOLBAR CONTROLS

Everything you reach for daily lives right inside the 380px Chrome toolbar popup—no digging through tabs.

OPEN CHAT RENAME & ↻ REGENERATE Rename the currently open Perplexity chat on demand or click ↻ Regenerate to craft a fresh non-repeating 3–7 word variation.

BATCH RENAME PERPLEXITY LIBRARY Retroactively clean up the Past 50 / 20 Chats, Last 20 / 30 Days, or All Library Chats—skipping already-renamed threads automatically.

INSTANT PROVIDER SWITCH & TEST LLM Swap between all 10 providers, replace your API key (write-only—never read back into popup DOM), and run a live latency check with TEST LLM.

SCROLL TO EXPLORE FULL PIXEL SETTINGS PAGE

Full Auto-Rename for Perplexity Settings page

FULL RULES, HISTORY & PRIVACY

Power-user controls for custom endpoints, regex exclusions, clickable thread history, and transparent data disclosure.

RUNTIME HOST PERMISSIONS Requests host access only for the specific LLM API origin you actually choose, keeping default install permissions minimal.

LINE-BY-LINE REGEX FILTERS Skip utility prompts automatically using standard case-insensitive regular expressions.

200-ITEM CLICKABLE RENAME LOG Every renamed thread links directly back to perplexity.ai/search/<backend_uuid> and can be cleared in one click.

Bring Your Own Key — Or No Key At All

10 LLM PROVIDERS + OFFLINE FALLBACK

Click any provider below to inspect its preconfigured fast model, wire protocol, and built-in reasoning-budget safeguards. Don’t want to configure an API key? The offline keyword heuristic works out of the box.

Groq

DEFAULT

Default Model	`openai/gpt-oss-20b`
Key Needed	API key (free tier available)
Endpoint	`https://api.groq.com/openai/v1/chat/completions`
Wire Protocol	OpenAI Chat Completions + Bearer token
Adapter Smarts

Engineering & Security Deep-Dive

3-WORLD MV3 STREAM ARCHITECTURE

Zero brittle DOM scraping and zero API-key exposure. Auto-Rename clones Perplexity’s SSE stream at the network boundary via Response.body.tee() while locking your API key strictly inside the background Service Worker.

3-World Chrome Manifest V3 Architecture Diagram

WORLD 1 · MAIN

STREAM TEE & RENAME BRIDGE

page.js wraps window.fetch at document_start, splits /rest/sse/perplexity_ask via response.body.tee() so Perplexity’s UI streams at native speed, and submits same-origin set_thread_title (HTTP 204). Has zero access to storage or API keys.

WORLD 2 · ISOLATED

DECISION GATE & SHADOW HUD

content.js evaluates shouldRename() (skipping follow-ups, manual edits, and regex exclusions), renders the isolated Shadow-DOM pixel HUD, and coordinates bounded 600ms / 1800ms retry backoff on transient 5xx errors.

WORLD 3 · SERVICE WORKER

EXCLUSIVE API KEY VAULT

background.js is the only module in the codebase that calls getApiKey() (enforced by automated tests). Calls your chosen LLM with a 10s AbortController, strips <think> tags, and falls back cleanly to heuristicTitle().

SRC/PAGE/INJECT.JS — NON-DESTRUCTIVE STREAM CLONING

const response = await originalFetch.apply(this, args);

if (isAskSseRequest && response.ok && response.body?.tee) {
  const [pageBranch, observerBranch] = response.body.tee();

  // Branch 2 assembles SSE frames asynchronously without touching UI rendering
  observeAskStream(observerBranch, requestMeta);

  // Branch 1 returns immediately to Perplexity's React app at native speed
  return new Response(pageBranch, {
    status: response.status,
    statusText: response.statusText,
    headers: response.headers,
  });
}

Get Started

INSTALL IN 60 SECONDS

Works in Google Chrome, Brave, Arc, Microsoft Edge, Vivaldi, and any Chromium browser supporting Manifest V3.

OPTION A · PREBUILT RELEASE ZIP

NO NODE.JS NEEDED

Download auto-rename-for-perplexity-v0.1.0.zip and unzip it into a folder on your computer.

Open chrome://extensions in your browser and flip on Developer mode (top-right corner).

Click Load unpacked and select the unzipped folder (the one containing manifest.json). Done!

⬇ DOWNLOAD V0.2.0 (.ZIP)

OPTION B · BUILD FROM SOURCE

ZERO RUNTIME DEPS

Clone the repository, bundle all 5 entrypoints with esbuild in ~35ms, verify all 64 tests, and load the extension/ folder unpacked:

TERMINAL

git clone https://github.com/sarang-cmd/perplexity-autorename.git
cd perplexity-autorename
npm install
npm run build && npm test

Questions & Answers

FREQUENTLY ASKED QUESTIONS

DOES THIS CHANGE PERPLEXITY.AI’S FONTS, THEME, OR PAGE LAYOUT?

No. Perplexity’s website layout, fonts, and CSS remain 100% untouched. Only the extension’s own toolbar popup, settings page, and isolated Shadow-DOM bottom-right status toast use the retro pixel HUD theme—and the toast can be disabled anytime with one click.

WHERE IS MY LLM API KEY STORED, AND CAN WEBSITES READ IT?

Your API key is stored locally on your device in chrome.storage.local and read exclusively inside the extension’s background MV3 Service Worker (src/background/service-worker.js). Neither perplexity.ai nor content scripts nor even the popup DOM ever read back the raw key string. Zero developer servers or analytics exist.

CAN I USE IT COMPLETELY FREE WITHOUT AN API KEY?

Yes! Out of the box with no API key saved, Auto-Rename uses its built-in offline keyword heuristic (heuristicTitle()) to generate clean 3–7 word titles locally with zero network requests. You can also use free-tier keys from Groq, Google AI Studio (Gemini), OpenRouter :free models, or a local Ollama server.

WILL IT OVERWRITE TITLES I RENAME MANUALLY OR ON FOLLOW-UP QUESTIONS?

Never. Follow-up messages and related-query clicks are skipped automatically via last_backend_uuid and is_related_query. And if you manually rename a thread in Perplexity’s sidebar, the extension detects that request and locks out auto-renaming for that thread permanently.

CAN I BATCH-RENAME OLD CHATS IN MY PERPLEXITY LIBRARY OR REGENERATE A TITLE?

Yes! Open the toolbar popup or Settings page to Rename or ↻ Regenerate the currently open chat on demand (or click ↻ REGEN right on the bottom-right HUD toast), or run Batch Rename Library across the Past 50 / 20 Chats, Last 20 / 30 Days, or All Library Chats with live progress and instant cancellation. Manual edits are always preserved.

Guides, Fixes & Tutorials

PERPLEXITY THREAD NAMING & SETUP GUIDES

Deep-dive walkthroughs on fixing truncated Perplexity sidebar titles, organizing your Library with prefixes & regex rules, setting up free Groq or local Ollama, and loading unpacked in any Chromium browser.

POPULAR FIX

Fix Messy Perplexity Thread Titles

Tired of Perplexity.ai using your raw prompt, stack trace, or truncated paragraph as the thread title? Fix Perplexity Library titles automatically in 60 seconds with Auto-Rename for Perplexity.

READ GUIDE →

WORKFLOW GUIDE

Organize Perplexity Library & History

Turn a cluttered Perplexity.ai Library into a searchable knowledge base using automatic 3–7 word titles, custom project prefixes like [Research] or [Bug], and regex exclude rules.

READ GUIDE →

INSTALL GUIDE

Install on Chrome, Brave, Arc & Edge

Step-by-step unpacked installation guide for Auto-Rename for Perplexity across Google Chrome, Brave, Arc, Microsoft Edge, and Vivaldi—no Chrome Web Store account or Node.js required.

READ GUIDE →

10 PROVIDERS + OFFLINE

Free Groq, Gemini & Local Ollama Setup

Compare all 10 supported LLM providers plus zero-key offline mode in Auto-Rename for Perplexity—including free Groq (gpt-oss-20b), Gemini 2.5 Flash, OpenRouter :free, and 100% local Ollama.

READ GUIDE →

COMPARISON

Perplexity vs ChatGPT & Claude Titles

ChatGPT and Claude automatically summarize new chats into short 3–6 word titles, while Perplexity.ai keeps your raw prompt. Learn why—and how to add automatic AI thread titles to Perplexity.

READ GUIDE →

DIAGNOSTICS & FIXES

Troubleshooting & Error Fixes

Quick fixes if Perplexity threads aren't auto-renaming: grant optional host permissions, fix Ollama HTTP 403 CORS origins, understand reasoning-model token budgets, and check HTTP 204 status.

READ GUIDE →

POWER-USER GUIDE

Perplexity Browser Workflow & Privacy

How to upgrade your daily Perplexity.ai research workflow in Chrome, Brave, Arc, and Edge with open-source Manifest V3 tooling, clean 3–7 word Library titles, and strict API key privacy.

READ GUIDE →