Getting started

Install Better Perplexity, take the built-in tour and learn where everything lives.

v1.0.3PolyForm-Strict-1.0.01 min read

Install#

  1. Install a userscript manager: Violentmonkey or Tampermonkey.
  2. Open the Install button on the overview page and confirm in your manager.
  3. Open perplexity.ai and sign in.

Updates arrive through your manager, and the script also checks for new versions about every 12 hours.

Take the tour#

Click the ? button in the header for guided tours. Each tour highlights real buttons and asks you to click or press the keys it describes.

Where things are#

WhereWhat
Header badgeRemaining queries for the selected mode; hover for a summary, click for details
Header buttonsExport, settings and the tutorial
Message box buttonsEnter-as-newline settings, big messages, prompt library, batch runner
Select any textA toolbar to ask, explain, summarize, fact-check or quote it

Turn modules on and off#

Open the settings dialog (the sliders button). Every feature is a module with its own switch and its own settings. Disabled modules stay completely idle.

Edit this page on GitHub

Search documentation

Jump to any page or section.

Better Perplexity
Install
Features
Shortcuts
Community prompts
Privacy
Troubleshooting
Built on the shared core
Development
License
Getting started
Install
Take the tour
Where things are
Turn modules on and off
Usage tracking
What the badge shows
Which mode is shown
Refill estimates
Refill estimates
When the numbers look wrong
Long messages
The size meter
Big messages
Sending in parts
Attaching as a file
Accuracy
Prompts and batches
Prompt library
Placeholders
Community prompts
Batch Runner
Code blocks and export
Code blocks
Exporting a thread
Citation styles
Shortcuts and settings
Default shortcuts
Enter as newline
Command palette
Selection toolbar
Layout
Architecture
What the core provides
What stays in Better Perplexity
Compatibility
Building from source
Troubleshooting
A button is missing
Usage shows free-tier numbers
My draft disappeared
Export fails
Updates do not arrive
The build cannot find @nolly/core
Reporting a bug
Changelog
[1.0.3] - 2026-11-09
Fixed
Changed
[1.0.2] - 2026-11-09
Changed
[1.0.1] - 2026-11-09
Changed
Fixed
[1.0.0] - 2026-11-08
Added
Community prompts
Suggest a prompt
Userscript Core
What you get
Quick start
Getting started
Scaffold
A feature
Wire it up
Cleanup
API reference
Runtime
Feature
Utilities
Build
Build and release
Changelog
0.1.1
0.1.0