cli-anything-zotero

cli-anything-zotero is an agent-native CLI for Zotero desktop. It does not reimplement Zotero. Instead, it composes Zotero's real local surfaces:

Installation

pip install -e .

Entry Points

cli-anything-zotero
python -m cli_anything.zotero

Important Constraints

• search items, item export, item citation, and item bibliography require Zotero's Local API to be enabled.
• note add depends on the live Zotero GUI context and expects the same library to be selected in the app.
• Import-time PDF attachment support is limited to items created in the same connector session; arbitrary existing-item attachment upload is still out of scope.
• Experimental SQLite write commands are local-only, user-library-only, and should be treated as non-stable power-user operations.
• If a bare key is duplicated across libraries, set session use-library <id> before follow-up commands.

Command Groups

App

Application and runtime inspection commands.

Command	Description
status	Execute status.
version	Execute version.
launch	Execute launch.
enable-local-api	Execute enable-local-api.
ping	Execute ping.

Collection

Collection inspection and selection commands.

Command	Description
list	Execute list.
find	Execute find.
tree	Execute tree.
get	Execute get.
items	Execute items.
use-selected	Execute use-selected.
create	Execute create.

Item

Item inspection and rendering commands.

Command	Description
list	Execute list.
find	Execute find.
get	Execute get.
children	Execute children.
notes	Execute notes.
attachments	Execute attachments.
file	Execute file.
export	Execute export.
citation	Execute citation.
bibliography	Execute bibliography.
context	Execute context.
analyze	Execute analyze.
add-to-collection	Execute add-to-collection.
move-to-collection	Execute move-to-collection.

Search

Saved-search inspection commands.

Command	Description
list	Execute list.
get	Execute get.
items	Execute items.

Tag

Tag inspection commands.

Command	Description
list	Execute list.
items	Execute items.

Style

Installed CSL style inspection commands.

Command	Description
list	Execute list.

Import

Official Zotero import and write commands.

Command	Description
file	Execute file.
json	Execute json.

Note

Read and add child notes.

Command	Description
get	Execute get.
add	Execute add.

Session

Session and REPL context commands.

Command	Description
status	Execute status.
use-library	Execute use-library.
use-collection	Execute use-collection.
use-item	Execute use-item.
use-selected	Execute use-selected.
clear-library	Execute clear-library.
clear-collection	Execute clear-collection.
clear-item	Execute clear-item.
history	Execute history.

Examples

Runtime Status

Inspect Zotero paths and backend availability.

cli-anything-zotero app status --json

Read Selected Collection

Persist the collection selected in the Zotero GUI.

cli-anything-zotero collection use-selected --json

Render Citation

Render a citation using Zotero's Local API.

cli-anything-zotero item citation <item-key> --style apa --locale en-US --json

Add Child Note

Create a child note under an existing Zotero item.

cli-anything-zotero note add <item-key> --text "Key takeaway" --json

Build LLM Context

Assemble structured context for downstream model analysis.

cli-anything-zotero item context <item-key> --include-notes --include-links --json

Version

0.1.0