Skip to content

How the Plugin connects Qiongli

For Codex or Claude Code, the Plugin is the simplest way to connect research Skills and MCP. Start with qiongli install plugin; the installer guides you through file export and official Host registration.

What gets installed

SurfaceGuidanceProgram and tools
CLI-exported PluginShared Skills, workflows and referencesBundled native executable; Full MCP, 32 tools
Native Marketplace platform PluginShared Skills, workflows and referencesBundled native executable; Lite MCP, 14 tools
Standalone SkillsExported guidance and referencesNo MCP connection or automatic Host registration

Both MCP profiles run without Python or Node. A package manager may have its own requirements: npm needs Node, PyPI needs Python, and Cargo builds with Rust. The standalone binary needs none of those language runtimes on its supported platform.

The Host loads Skills from its registered Plugin cache and starts MCP when needed. You do not need to copy the Plugin into ~/.agents/skills or run a background MCP terminal. A Skills-only export must be installed through your Host separately.

Refresh and verify

After upgrading the CLI through its original channel, run qiongli install plugin again. It reuses the registered source directory. The file preview and Host registration each require confirmation. Known Codex Plugin migration is available in 2.0.0. If you still use beta.6, update the CLI first or disable a conflicting Plugin manually. See the installation guide for the exact boundary.

Run qiongli doctor and qiongli install list, then start a new Host session and check its actual Qiongli tools. Registration alone does not verify session tools, provider access or Hook execution. Optional hooks need separate Host trust.

Where maintainers edit

Shared guidance lives in content/; native implementation lives in packages/qiongli-native/. Plugin exports and registry packages are generated from those sources. A release staging workspace holds generated files; packaging does not write generated payloads back to the source checkout.

See repository structure and release policy before changing packaging.

Qiongli documentation