Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/chrisgrieser/alfred-bibtex-citation-picker/llms.txt

Use this file to discover all available pages before exploring further.

Getting Supercharged Citation Picker up and running takes only a few minutes. The workflow ships as a single .alfredworkflow file and requires no package manager or build step — download, double-click, and configure your .bib path to be ready to cite.
This workflow requires Alfred’s Powerpack license. The Powerpack is a one-time paid upgrade that unlocks workflow support in Alfred. You can purchase it at alfredapp.com/powerpack. The workflow will not install without it.

Setup steps

1

Download the latest release

Go to the latest release page on GitHub and download the .alfredworkflow file attached to the release.
2

Install into Alfred

Double-click the downloaded .alfredworkflow file. Alfred will open an import dialog. Click Import to add the workflow to your Alfred library.
3

Set your BibTeX library path

Open Alfred PreferencesWorkflows → select Supercharged Citation Picker → click Configure Workflow (the [x] button in the top-right toolbar). Set the bibtex_library_path variable to the full path of your primary .bib file (e.g. ~/Documents/references.bib).
4

(Optional) Add a secondary library

If you maintain two separate .bib files, set the secondary_library_path variable in the same configuration panel. Both libraries are searched simultaneously, and entries from the secondary library are marked with a 2️⃣ icon.
5

Select your citation format

Type scp in Alfred and select Change citation format from the list. Choose the format that matches your writing environment. The default is Pandoc ([@citekey]). Available formats include LaTeX, org mode, Multi-Markdown, iA Writer, eta templates, [[wikilinks]], #tags, bare citekeys, and bracketed citekeys.
6

Assign a hotkey

In the Alfred workflow editor, locate the Hotkey trigger block at the top of the workflow canvas. Double-click it and press your preferred key combination (e.g. ⌥Space or ⌃⌥C). This lets you open the citation picker from any text field without typing a keyword.

Configuration reference

The table below lists every available workflow variable. All variables are set via Alfred Preferences → Workflows → Supercharged Citation Picker → Configure Workflow.
SettingRequiredDescription
bibtex_library_path✅ YesFull path to your primary .bib file. The workflow cannot function without this.
secondary_library_pathNoFull path to an optional second .bib file. Both libraries are searched together.
literature_note_folderNoFolder where Markdown literature notes are stored or created. Files must be named exactly after their citekey.
pdf_folderNoFolder where PDFs are stored for auto-filing and quick-open. PDFs must be named {citekey}.pdf or {citekey}_{any text}.pdf.
csl_for_pandocNoPath to a .csl citation style file used for the Formatted single entry and Paste full bibliography actions. Defaults to APA 7th if not set.

Pandoc (optional)

Pandoc is only needed for two features:
  • Formatted single entry — pastes a fully rendered bibliography entry for the selected item (e.g. a complete APA reference string).
  • Paste full bibliography — pastes a formatted bibliography string via ⌘⌥↵.
All other citation formats and workflow features work without Pandoc installed.

Build docs developers (and LLMs) love