📘 Khy-OS 文档站 🧭 新手先读：核心概念

# cli-anything-zotero

name: "cli-anything-zotero"
description: >-
CLI harness for 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#

    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