nushell/plugin-examples

Plugin examples for Nushell in different languages.

About

This repo has example Nushell plugins written in different languages.
Each plugin is tested daily via CI against the latest main branch of nushell.
You can use them as a starting point for building your own plugin.

For more real plugins, check out nushell/awesome-nu.

Plugins

Plugins are organized by language (e.g. rust/) and live in their own folders.
Each folder usually includes:

• a test file
• a .cmd file if the plugin needs a scripting runtime (helps with local testing on Windows)

Every plugin is also listed in the CI workflow to ensure it gets tested regularly.

Write your own plugin

This repo contains examples of how to implement specific behaviors in Nushell plugins. If you want to stream data, return a table, handle arguments, or work with custom types, there's likely an example here that shows how to do it.

To build your own plugin from scratch:

• Start with our official plugin template for a clean setup:
  👉 nushell/nu_plugin_template

• Read the full plugin guide in the Nushell book:
  📚 Plugin guide on nushell.sh

You might need to update the Nushell dependencies in the plugin template, since it can lag behind the latest nushell version.
For more real-world plugins, check out
nushell/awesome-nu.