mofa plugin

The mofa plugin command provides plugin management including installation, listing, and repository configuration.

Subcommands

list

List installed or available plugins

info

Show plugin details

install

Install a plugin

uninstall

Uninstall a plugin

repository

Manage plugin repositories

mofa plugin list

List installed or available plugins.

Usage

mofa plugin list [OPTIONS]

Options

`--installed`

Show only installed plugins.

Type: Boolean flag
Default: false

mofa plugin list --installed

`--available`

Show available plugins from catalog.

Type: Boolean flag
Default: false

mofa plugin list --available

If neither flag is specified, shows installed plugins by default.

Examples

List installed plugins

mofa plugin list --installed

Output:

→ Installed plugins

┌───────────────┬────────┬────────┬──────────────────────────────┐
│ ID            │ Kind   │ Repo   │ Description              │
├───────────────┼────────┼────────┼──────────────────────────────┤
│ web-search    │ tool   │ official │ Web search capability    │
│ code-exec     │ tool   │ official │ Code execution sandbox   │
│ memory-redis  │ memory │ official │ Redis-backed memory      │
└───────────────┴────────┴────────┴──────────────────────────────┘

List available plugins

mofa plugin list --available

Output:

→ Available plugin catalog

┌───────────────┬────────────────┬──────────┬────────┬──────────────────────────────┬───────────┐
│ ID            │ Name           │ Repo     │ Kind   │ Description              │ Installed │
├───────────────┼────────────────┼──────────┼────────┼──────────────────────────────┼───────────┤
│ web-search    │ Web Search     │ official │ tool   │ Web search capability    │ yes       │
│ code-exec     │ Code Executor  │ official │ tool   │ Code execution sandbox   │ yes       │
│ pdf-reader    │ PDF Reader     │ official │ tool   │ Extract text from PDFs   │ no        │
│ memory-redis  │ Redis Memory   │ official │ memory │ Redis-backed memory      │ yes       │
└───────────────┴────────────────┴──────────┴────────┴──────────────────────────────┴───────────┘

mofa plugin info

Show detailed information about a plugin.

Usage

mofa plugin info <NAME>

Arguments

`<NAME>`

Required. Plugin name or ID.

mofa plugin info web-search

Examples

mofa plugin info web-search

Output:

Plugin: web-search
Name: Web Search
Kind: tool
Repository: official
Version: 1.0.0
Installed: yes

Description:
  Provides web search capability using multiple search engines
  (Google, Bing, DuckDuckGo).

Capabilities:
  - Search the web for information
  - Extract page content
  - Follow search result links

Configuration:
  search_engine: google
  max_results: 10
  timeout_seconds: 30

Dependencies:
  - reqwest
  - scraper
  - tokio

mofa plugin install

Install a plugin from a repository, local path, or URL.

Usage

mofa plugin install <NAME> [OPTIONS]

Arguments

`<NAME>`

Required. Plugin name, path, or URL.

# Install from catalog
mofa plugin install web-search

# Install from local path
mofa plugin install ./my-plugin

# Install from URL
mofa plugin install https://github.com/user/plugin

Options

`--checksum <HASH>`

Expected SHA256 checksum for verification.

Type: String (hex)
Default: None (skip verification)

mofa plugin install web-search --checksum abc123...

`--verify-signature`

Verify plugin signature if available.

Type: Boolean flag
Default: false

mofa plugin install web-search --verify-signature

Examples

Install from catalog

mofa plugin install web-search

Output:

→ Installing plugin: web-search
  Repository: official
  Downloading...
  ✓ Downloaded (1.2 MB)
  Extracting...
  Registering...
✓ Plugin 'web-search' installed successfully

Install with checksum verification

mofa plugin install web-search \
  --checksum abc123def456...

Output:

→ Installing plugin: web-search
  Repository: official
  Downloading...
  Verifying checksum...
  ✓ Checksum verified
  Extracting...
  Registering...
✓ Plugin 'web-search' installed successfully

Install from local path

mofa plugin install ./my-custom-plugin

Output:

→ Installing plugin from local path: ./my-custom-plugin
  Loading plugin manifest...
  Validating...
  Registering...
✓ Plugin 'my-custom-plugin' installed successfully

Error Codes

Code	Description
`0`	Plugin installed successfully
`1`	Plugin not found
`2`	Checksum mismatch
`3`	Invalid plugin format
`4`	Network error

mofa plugin uninstall

Uninstall a plugin.

Usage

mofa plugin uninstall <NAME> [OPTIONS]

Arguments

`<NAME>`

Required. Plugin name or ID to uninstall.

mofa plugin uninstall web-search

Options

`--force`

Skip confirmation prompt.

Type: Boolean flag
Default: false

mofa plugin uninstall web-search --force

Examples

Interactive uninstall

mofa plugin uninstall web-search

Output:

→ Uninstalling plugin: web-search

Warning: This will remove the plugin and its data.
Continue? [y/N]: y

  Removing plugin files...
  Unregistering...
✓ Plugin 'web-search' uninstalled successfully

Force uninstall

mofa plugin uninstall web-search --force

Output:

→ Uninstalling plugin: web-search
  Removing plugin files...
  Unregistering...
✓ Plugin 'web-search' uninstalled successfully

mofa plugin repository

Manage plugin repositories.

Subcommands

`list`

List configured repositories.

mofa plugin repository list

Output:

Configured Plugin Repositories:

  official
  URL: https://plugins.mofa.dev/registry
  Description: Official MoFA plugin repository

  community
  URL: https://github.com/mofa-community/plugins
  Description: Community-maintained plugins

Total: 2 repositories

`add`

Add a new repository.

mofa plugin repository add <ID> <URL> [OPTIONS]

Arguments:

<ID> - Repository identifier (required)
<URL> - Repository URL (required)

Options:

-d, --description <TEXT> - Repository description

Examples:

mofa plugin repository add my-repo \
  https://github.com/user/plugins \
  --description "My custom plugins"

Output:

→ Adding plugin repository: my-repo
  URL: https://github.com/user/plugins
  Description: My custom plugins
  Fetching repository metadata...
✓ Repository 'my-repo' added successfully

Plugin Types

MoFA supports several plugin types:

Tool Plugins

Extend agent capabilities with new tools. Examples:

web-search - Web search capability
code-exec - Code execution
pdf-reader - PDF text extraction
image-gen - Image generation

Memory Plugins

Provide different memory backends. Examples:

memory-redis - Redis-backed memory
memory-postgres - PostgreSQL memory
memory-vector - Vector database memory

Reasoner Plugins

Implement reasoning strategies. Examples:

react-reasoner - ReAct pattern reasoning
cot-reasoner - Chain-of-thought reasoning
tree-of-thought - Tree exploration reasoning

Coordinator Plugins

Multi-agent coordination patterns. Examples:

sequential-coordinator - Sequential execution
parallel-coordinator - Parallel execution
debate-coordinator - Multi-agent debate

Plugin Security

Always verify plugins from untrusted sources. Plugins have full access to your system.

Best Practices

Use checksums - Always verify checksums for downloaded plugins
Official repository - Prefer plugins from the official repository
Review source - Review plugin source code before installation
Least privilege - Only install plugins you need
Keep updated - Regularly update installed plugins

Verification

# Verify checksum
mofa plugin install plugin-name \
  --checksum abc123...

# Verify signature
mofa plugin install plugin-name \
  --verify-signature

Common Workflows

Discover and install plugins

# Browse available plugins
mofa plugin list --available

# Get plugin details
mofa plugin info web-search

# Install plugin
mofa plugin install web-search

Manage installed plugins

# List installed
mofa plugin list --installed

# Check plugin info
mofa plugin info web-search

# Uninstall
mofa plugin uninstall web-search

Add custom repository

# Add repository
mofa plugin repository add my-repo \
  https://github.com/user/plugins

# List plugins from new repo
mofa plugin list --available

# Install from custom repo
mofa plugin install my-plugin

Commands

​Subcommands

list

info

install

uninstall

repository

​mofa plugin list

​Usage

​Options

​--installed

​--available

​Examples

​List installed plugins

​List available plugins

​mofa plugin info

​Usage

​Arguments

​<NAME>

​Examples

​mofa plugin install

​Usage

​Arguments

​<NAME>

​Options

​--checksum <HASH>

​--verify-signature

​Examples

​Install from catalog

​Install with checksum verification

​Install from local path

​Error Codes

​mofa plugin uninstall

​Usage

​Arguments

​<NAME>

​Options

​--force

​Examples

​Interactive uninstall

​Force uninstall

​mofa plugin repository

​Subcommands

​list

​add

​Plugin Types

​Tool Plugins

​Memory Plugins

​Reasoner Plugins

​Coordinator Plugins

​Plugin Security

​Best Practices

​Verification

​Common Workflows

​Discover and install plugins

​Manage installed plugins

​Add custom repository

​See Also

Build docs developers (and LLMs) love

Subcommands

mofa plugin list

Usage

Options

`--installed`

`--available`

Examples

List installed plugins

List available plugins

mofa plugin info

Usage

Arguments

`<NAME>`

Examples

mofa plugin install

Usage

Arguments

`<NAME>`

Options

`--checksum <HASH>`

`--verify-signature`

Examples

Install from catalog

Install with checksum verification

Install from local path

Error Codes

mofa plugin uninstall

Usage

Arguments

`<NAME>`

Options

`--force`

Examples

Interactive uninstall

Force uninstall

mofa plugin repository

Subcommands

`list`

`add`

Plugin Types

Tool Plugins

Memory Plugins

Reasoner Plugins

Coordinator Plugins

Plugin Security

Best Practices

Verification

Common Workflows

Discover and install plugins

Manage installed plugins

Add custom repository

See Also