qiongli 0.11.0

Installer/upgrader CLI for qiongli (Codex / Claude Code / Gemini) without requiring a git fork.

qiongli

qiongli is the lightweight updater CLI for Qiongli (穷理), a contract-driven academic workflow system for Codex, Claude Code, and Gemini.

The full system name is Qiongli Zhengche (穷理证澈): Qiongli names the public research workflow, while Zhengche names the evidence-governance method that keeps claims, citations, assumptions, and output paths auditable.

What it does

• Install or refresh global qiongli-workflow skill assets
• Upgrade assets to newer upstream versions
• Support codex, claude, gemini, or all targets
• Run doctor checks before/after installation

Installation

For a global CLI command, pipx is recommended:

pipx install qiongli

Upgrade an existing PyPI install with:

pipx upgrade qiongli

You can also install with pip:

pip install qiongli

If you use pip inside an active virtual environment, the CLI is installed into that environment. That only affects where the Python command lives; it does not make the workflow assets project-local.

Global-first update model

Current releases separate the package install from workflow asset installation:

• pipx install qiongli / pipx upgrade qiongli updates the lightweight Python CLI.
• qiongli upgrade --target all refreshes the global qiongli-workflow skill assets for Codex, Claude Code, Gemini, and Antigravity.
• --project-dir is not required for normal global upgrades. It only selects a project when you run doctor, load project-level qiongli.toml / .qiongli.toml, or explicitly write project files with qiongli init / --parts project.

Global assets are written under client home directories such as:

~/.codex/skills/qiongli-workflow
~/.claude/skills/qiongli-workflow
~/.gemini/skills/qiongli-workflow

CLI

Main command and aliases:

• qiongli
• ql
• research-skills (legacy)
• rsk
• rsw

Check updates

qiongli check

Upgrade assets

qiongli upgrade --target all

Run doctor only when you want to check a specific project runtime:

qiongli upgrade --target all --doctor --project-dir /path/to/project

The package includes a default upstream repo (jxpeng98/qiongli), so --repo is optional. Use --repo only when you want to override the default.

Override default repo (optional)

The CLI resolves upstream repo in this order:

1. --repo argument
2. QIONGLI_REPO environment variable
3. legacy RESEARCH_SKILLS_REPO environment variable
4. qiongli.toml or .qiongli.toml in your project path
5. Packaged default (qiongli/project.toml)

Option A: Global override

Add this to your shell profile (~/.zshrc, ~/.bashrc, etc.):

export QIONGLI_REPO="<owner>/<repo>"

Then reload shell:

source ~/.zshrc

Now you can run:

qiongli check
qiongli upgrade --target all

Option B: Project-level override

Create qiongli.toml in your project root:

[upstream]
repo = "jxpeng98/qiongli"
url = "https://github.com/<owner>/<repo>"

This keeps the override local to that project.

Typical usage

# Install or update the CLI from PyPI
pipx install qiongli
pipx upgrade qiongli

# Refresh global workflow assets
qiongli upgrade --target all

# Optional: initialize project-local files only when you want them
qiongli init --project-dir /path/to/project

Links

• Repository: https://github.com/jxpeng98/qiongli
• Issues: https://github.com/jxpeng98/qiongli/issues