Guide

Use this section when you are operating Qiongli as a user or project owner. It keeps the path short: install the smallest useful surface, learn what to type, choose a research route, then add runtime checks only when needed.

Start Here

• Quickstart: smallest install surface, first workspace, paper routes, and quality-gate context.
• Install: native plugin, bootstrap, npm, and pipx install surfaces.
• Using Agent Skills: what to type after install in Codex, Claude Code, Antigravity, Hermes, and the shell.
• Task Recipes: scenario-based routes for literature review, empirical design, writing, code, and rebuttal.
• Multi-Agent Runtime Guide: runtime routing, local agent execution, and auth rules.
• Examples: paper-type playbooks for systematic review, empirical, qualitative, methods, and theory workflows.
• Upgrade: npm asset refreshes, full-runtime package updates, shell bootstrap, Python CLI, and long-lived clone paths.
• Troubleshooting: unified error-code guide.

Recommended Reading Order

1. Quickstart
2. Install
3. Using Agent Skills
4. Task Recipes
5. Multi-Agent Runtime Guide
6. CLI Reference
7. Troubleshooting

Update Boundary

• On npm/npx, use qiongli update or qiongli refresh to reapply assets from the current package.
• On npm/npx, use qiongli upgrade for an overwrite asset refresh from the current package.
• Full runtime package self-update, including qiongli self-update, requires the Python runtime first: pipx install qiongli.

When To Leave This Section

• Need the layer model or dependency rules: go to Architecture or Conventions.
• Need MCP/Zotero/provider setup: go to Advanced.
• Need to modify the system itself: go to Maintainer.