Files
worldwideview/packages/wwv-cli/README.md
Antigravity AI d2bdb0cee8 feat(cli): enhance publish command and update default create directory
- feat(cli): Add --org flag to publish to allow publishing under custom NPM scopes (Minor).
- feat(cli): Allow publish command to run from project root via path resolution (Minor).
- feat(cli): Change create default scaffolding to local-plugins/ instead of packages/ (Minor).
- feat(cli): Add --core flag to create to override default and scaffold into packages/ (Minor).
- docs: Update tutorial, CLI readmes, and agent architecture workflows with new commands (Fix).
2026-05-13 10:57:33 +12:00

1.6 KiB

@worldwideview/wwv-cli

The official Command Line Interface for scaffolding and publishing WorldWideView plugins.

Usage

This CLI is designed to be run from within the worldwideview monorepo.

1. Scaffold a new plugin

node packages/wwv-cli/dist/index.js create

This command generates a new plugin directory with a boilerplate index.ts and package.json configured for the WorldWideView plugin architecture inside the local-plugins/ directory.

(Note: To create a built-in plugin inside packages/ instead, use the --core flag).

2. Publish a plugin

Once your plugin is ready for release, you can publish it to NPM. You can do this from within the plugin directory or directly from the project root.

From the plugin directory:

cd local-plugins/<plugin-name>
npm login
node ../../packages/wwv-cli/dist/index.js publish

From the project root: You can also run the CLI from the root by providing the plugin name:

node packages/wwv-cli/dist/index.js publish <plugin-name>

Custom NPM Organizations: By default, plugins are scaffolded under the @worldwideview NPM scope. To publish to your own organization, use the --org flag:

node packages/wwv-cli/dist/index.js publish <plugin-name> --org my-username

This will permanently update your package.json to use @my-username and publish the package.

The publish command verifies that your package.json contains the required "worldwideview" manifest block and invokes npm publish --access public.

Development

To re-compile the CLI during development:

pnpm --filter @worldwideview/wwv-cli run build