Metadata-Version: 2.4
Name: qiongli
Version: 2.5.1
Summary: Native academic research CLI
Requires-Python: >=3.9
License-Expression: MIT
License-File: LICENSE
Description-Content-Type: text/markdown

# Qiongli 2.5.1

Native academic research CLI

Qiongli includes research Skills, templates and Lite/Full MCP. Your Host supplies
the model and its credentials; no Qiongli desktop App is required. The supported
binary targets are macOS Apple Silicon, Windows x64 and Linux x64/ARM64 (glibc 2.35+).

## Install and update

Requires Python 3.9+. The wheel includes the native executable and a small
Python launcher; no additional Python packages are required.

```sh
python -m pip install --upgrade "qiongli==2.5.1"
```

Use `python -m pip uninstall qiongli` to remove this package. Run `qiongli setup`
after installation to review other CLI copies visible on this computer.

## Use the CLI

`qiongli` and `ql` share the same commands. Start with:

```sh
qiongli --version
qiongli install
qiongli mcp check
qiongli doctor
qiongli content
qiongli help install plugin
```

In a terminal, `install` opens the guide. `install plugin` installs or refreshes
the bundled Plugin using its registered source directory. File changes and official
Host registration require separate confirmations; `upgrade plugin` is an alias.
The Host loads Skills and Full MCP from its Plugin cache, with no copy into
`.agents/skills`. `install skills` only exports guidance to `.qiongli-skills`.
Start a new Host session after updating; registration alone does not prove its
tools are available.

Use `--json` for scripts. Scripts and MCP never prompt. `qiongli setup` reviews
visible installations without deleting files, changing PATH or replacing model settings.
If another CLI takes precedence, invoke the selected executable by its full path.
Research writes retain preview, explicit approval and revision checks. Keep earlier
research records and backups when migrating; upgrading a package does not authorize cleanup.

[Command and installation guide](https://github.com/jxpeng98/qiongli/blob/v2.5.1/docs/guide/cli-2x.md)
