Skip to main content

​
Synopsis

profclaw plugin <subcommand> [flags]

​
Description

plugin manages the profClaw plugin ecosystem. Plugins extend profClaw with new tools, chat channels, integrations, and skills. They can be installed from npm (packages named profclaw-plugin-*) or from ClawHub (the community skill registry). You can also scaffold new plugins from templates.

​
Subcommands

SubcommandDescription
listList installed plugins from all sources
install <package>Install a plugin from npm
uninstall <package>Uninstall a plugin
search [query]Search npm and ClawHub for plugins
create <name>Scaffold a new plugin project

​
plugin list

Shows plugins from three sources: loaded plugin directories, marketplace-tracked installs, and ClawHub skills.
​
--clawhub
boolean
Also show ClawHub-installed skills in the output.

​
plugin install <package>

Installs a plugin from npm. The package name is resolved automatically: github becomes profclaw-plugin-github.
​
package
string
required
Package name. Can be short form (github) or full form (profclaw-plugin-github).
​
-v, --version
string
Specific version to install (e.g., 1.2.3). Defaults to latest.

​
plugin uninstall <package>

​
package
string
required
Package name to uninstall (short or full form).

​
plugin search [query]

Searches both npm and ClawHub for plugins matching the query. Returns package names, descriptions, and categories.
​
query
string
Search terms. Omit to browse all available plugins.
​
--npm-only
boolean
Search npm packages only.
​
--clawhub-only
boolean
Search ClawHub only.

​
plugin create <name>

Scaffolds a new plugin project with the correct structure, package.json, and example code.
​
name
string
required
Plugin name (without the profclaw-plugin- prefix). Creates profclaw-plugin-<name>/.
​
-t, --type
string
default:"tool"
Plugin type: tool, channel, integration, or skill.
​
-d, --description
string
Plugin description for package.json.
​
-a, --author
string
Author name for package.json.
​
-o, --output
string
Output directory. Defaults to ./profclaw-plugin-<name>/.

​
Examples

profclaw plugin search
profclaw plugin search github
profclaw plugin search --clawhub-only

​
Plugin Types

TypeDescription
toolAdds new tools to the agent execution registry
channelAdds a new chat channel provider (e.g., a messaging platform)
integrationConnects to an external service (ticketing, CI/CD, etc.)
skillAdds pre-built AI skill definitions

​
Plugin Directories

Plugins are loaded from: 
~/.profclaw/plugins/    # User-installed plugins
./plugins/              # Project-local plugins
node_modules/profclaw-plugin-*/  # npm-installed plugins