cli-anything-zotero

# 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 ```bash pip install -e . ``` ## Entry Points ```bash 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. ```bash cli-anything-zotero app status --json ``` ### Read Selected Collection Persist the collection selected in the Zotero GUI. ```bash cli-anything-zotero collection use-selected --json ``` ### Render Citation Render a citation using Zotero's Local API. ```bash 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. ```bash cli-anything-zotero note add <item-key> --text "Key takeaway" --json ``` ### Build LLM Context Assemble structured context for downstream model analysis. ```bash cli-anything-zotero item context <item-key> --include-notes --include-links --json ``` ## Version 0.1.0