{"id":18102,"library":"amos-plugin-cli","title":"amos-plugin-cli","description":"A CLI tool for installing, generating, and publishing plugins for the Amos framework (v1.2.0). It supports plugin lifecycle management including scaffolding, packaging, and distribution. Key features include configurable plugin sources, extensible copy commands (MF and UMD), and multi-source configuration (environment variables, .pluginsrc, package.json). Release cadence appears irregular. Differentiates from generic plugin managers by tight coupling with Amos framework conventions and support for Chinese-language documentation.","status":"active","version":"1.2.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript"],"install":[{"cmd":"npm install amos-plugin-cli","lang":"bash","label":"npm"},{"cmd":"yarn add amos-plugin-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add amos-plugin-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This is a CLI tool, not a library. Use npx or global install, not require().","wrong":"const amosPlugin = require('amos-plugin-cli')","symbol":"amos-plugin","correct":"npx amos-plugin <command>"}],"quickstart":{"code":"npm install -g amos-plugin-cli\n# View help\namos-plugin -h\n# Create a new plugin project scaffold\namos-plugin -t\n# Package current plugin into a tarball (ZIP)\namos-plugin -p\n# Install a plugin named 'hello' from configured site\namos-plugin hello\n# Install with custom extension and site\namos-plugin hello --ext rar --amos-plugin-site http://localhost:3333/plugins","lang":"javascript","description":"Shows installation, scaffolding, packaging, and custom configuration of a plugin."},"warnings":[{"fix":"Configure via .pluginsrc or package.json 'amosPluginConfig' instead of env vars.","message":"Environment variables (AMOS_PLUGIN_*) may conflict with other tools. Use .pluginsrc or package.json for isolation.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use .mfrc.json or .umdrc.js format. Check version-specific examples in README.","message":"The --mf and --umd options copy module federation/UMD files but their configuration format (mfrc/umdrc) changed in 1.1.x.","severity":"deprecated","affected_versions":">=1.1.0"},{"fix":"Ensure plugins are ZIP archives. Custom extensions only apply to remote plugin storage, not local packaging.","message":"Plugin packaging (-p) only supports ZIP format despite config allowing other extensions.","severity":"gotcha","affected_versions":"<=1.2.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Install globally: npm install -g amos-plugin-cli. Or run with npx: npx amos-plugin -v.","cause":"Module not installed globally or npx not used.","error":"CLI_NOT_FOUND"},{"fix":"Create .pluginsrc in project root with at least amos_plugin_site and amos_plugin_dir.","cause":".pluginsrc or package.json missing required config fields.","error":"CONFIG_FILE_MISSING"},{"fix":"Re-package plugin with amos-plugin -p, ensuring project structure includes index.plugin.js.","cause":"Plugin ZIP file corrupted or missing index.plugin.js.","error":"PLUGIN_ARCHIVE_INVALID"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}