Pramaana
Pramaana is a free, open-source command-line reference manager for Linux, macOS, and Windows.
What Pramaana is
Pramaana is a free, open-source command-line reference manager for Linux, macOS, and Windows. It uses BibTeX as its documented storage format and arranges references in nested folders with PDFs and other attachments. Commands cover creating and editing references, listing, finding, grepping, showing, opening, searching, importing, exporting, moving, copying, linking, and removing files. References can be created from URLs or templates, with attachments taken from a specified path or the Downloads folder. Zotero users can import a specially configured BetterBibTeX export, including attachment and collection fields. URL imports require a running Zotero Translation Server. Attachments may be copied, moved, or hardlinked, with hardlinking as the default. Export settings support source patterns and a destination BibTeX file. Configuration includes storage location, attachment behavior, server address, exports, and templates. The recommended pipx installation provides an isolated environment and global command access. Python 3.8 or newer is required, and the package uses an MIT license.
Good
- Works on Linux, macOS, and Windows
- Organizes references and attachments in nested folders
- Supports creating, searching, importing, and exporting
- Attachments can be copied, moved, or hardlinked
- Configurable storage, templates, and export settings
Watch out
- BibTeX is the only documented storage format
- URL imports require a running Translation Server
- Published Translation Server module has known limitations
- Zotero import and server behavior still need work
Who it suits
It suits users who prefer terminal and file-manager operations for references, folders, and PDFs instead of extensive point-and-click use. Zotero users can use its configured BetterBibTeX import.
Verdict
Pramaana provides command-line control over BibTeX references, files, and folder organization across three desktop platforms. Its dependence on BibTeX and a separately running Translation Server matters when planning imports.
The facts
Each one read from Pramaana's own pages, with the date it was checked.
What it does
- Customization
- Users can configure the storage path, attachment behavior, translation server address, exports, and reference templates.checked 4 Oct 2026
- Development status
- The README lists Zotero import and Translation Server behavior among items that still need work.checked 11 Oct 2026
- Exports
- Users can configure BibTeX exports with include and exclude patterns, and exports run automatically after several reference operations.checked 11 Oct 2026
- File handling
- Attachments can be copied, moved, or hardlinked, and the import default is hardlinking.checked 4 Oct 2026
- Installation
- The maker recommends installing Pramaana with pipx, which makes the pramaana command available globally in an isolated environment.checked 11 Oct 2026
- Integrations
- URL-based imports require a running Zotero Translation Server, and Zotero libraries can be imported using a specially configured BetterBibTeX export.checked 11 Oct 2026
- Intended user
- The maker describes it for users who prefer managing references, folders, and PDFs through terminal or file-manager operations instead of extensive point-and-click use in Zotero.checked 11 Oct 2026
- Known limitation
- The maker says the published Zotero Translation Server module does not work as well as the one Zotero itself uses.checked 11 Oct 2026
- Organization
- References and attachments can be organized in nested folders that users can move or edit with command-line and file-manager tools.checked 11 Oct 2026
- Purpose
- Pramaana is a minimalist command-line reference manager that works with BibTeX files and the Zotero Translation Server.checked 11 Oct 2026
- Reference creation
- It can create references from URLs or templates and attach files from a specified path or the Downloads folder.checked 11 Oct 2026
- Reference operations
- Commands include creating and editing references, searching, exporting, importing, and moving or copying files.checked 4 Oct 2026
- Reference organization
- It organizes references into nested folders alongside their PDFs and other files.checked 4 Oct 2026
- Requirements
- The package metadata requires Python 3.8 or newer and lists an MIT license.checked 11 Oct 2026
- Search and commands
- Commands include listing, finding, grepping, showing, opening, moving, copying, linking, and removing references.checked 11 Oct 2026
- Shell support
- The README documents command, path, export, and template completions for bash and zsh.checked 11 Oct 2026
- Storage limit
- BibTeX is the only supported storage format in the documented configuration.checked 4 Oct 2026
- URL imports
- URL-based reference imports require the Zotero Translation Server to be running.checked 4 Oct 2026
- Zotero integration
- It can import a specially configured BetterBibTeX export from Zotero, including attachment and collection fields.checked 4 Oct 2026
Alternatives to Pramaana
- 1
Zotero
Free planOpen sourceAndroidiOSWebAPI8.6From $20 a year - 2
Sciwand
Free planiOSExtensionLinuxmacOS7.7$29.99 one-time - 3
refbase
Free planOpen sourceWebAPILinuxmacOS7.5Free plan - 4
Avidemux
Free planOpen sourceWebLinuxmacOSWindows7.3Free plan - 5
JabRef
Free planOpen sourceAPIExtensionLinuxmacOS7.3Free plan - 6
Mendeley Reference Manager
Free planWebExtensionLinuxmacOS7.2From $55 a year