n25/pages/plugins-slide.md

---
level: 2
---

# RunCommand plugins

Plugins are any script or executable that print output and exit with a system code of 0 (OK) or greater (error).

````md magic-move {lines: true}
```bash 
#!/usr/bin/env bash

echo "HI THERE..."

exit 0
```

```bash 
#!/usr/bin/env bash

# do some work...
sleep 10

echo "call the president..."

exit 1
```


````

<!--

RunCommand plugins are scripts or executables that do two things

1. print some output that can be seen and logged
2. exit with a system code

The example is of a bash script but it could be any scripting language that can do the same.

It could be a compiled program, so long as it also outputs logging information to the terminal and exits with a system code of [0|1 or greater]

Long running scripts or commands are expected

exiting with 1 or greater will signify a failure of some kind


-->