From a90870d7aa08f046cd79d43e658c29120efb27fb Mon Sep 17 00:00:00 2001
From: Joel Wetzell <git@jwetzell.com>
Date: Fri, 11 Sep 2026 09:23:51 -0500
Subject: [PATCH] add docs for os processors

---
 astro.config.mjs                        |  5 +++++
 src/content/docs/processors/os/exec.mdx | 23 +++++++++++++++++++++++
 2 files changed, 28 insertions(+)
 create mode 100644 src/content/docs/processors/os/exec.mdx

diff --git a/astro.config.mjs b/astro.config.mjs
index dc1e3d8..1abf108 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -225,6 +225,11 @@ export default defineConfig({
               collapsed: true,
               items: [{ autogenerate: { directory: "processors/module" } }],
             },
+            {
+              label: "OS",
+              collapsed: true,
+              items: [{ autogenerate: { directory: "processors/os" } }],
+            },
             {
               label: "OSC",
               collapsed: true,
diff --git a/src/content/docs/processors/os/exec.mdx b/src/content/docs/processors/os/exec.mdx
new file mode 100644
index 0000000..f79cbb6
--- /dev/null
+++ b/src/content/docs/processors/os/exec.mdx
@@ -0,0 +1,23 @@
+---
+title: Execute Command
+sidebar:
+  label: Exec
+  order: 1
+---
+import SchemaInfo from '../../../../components/SchemaInfo.astro';
+
+This processor will execute a command with the provided arguments. This processor will return an error if any of the required parameters are missing or if the parameters are of the wrong type. The command parameter is required, while the args parameter is optional.
+
+<SchemaInfo type="processor" id="os.exec"/>
+
+### Example
+
+Run `echo` command.
+  
+```yaml
+- id: create
+  type: os.exec
+  params:
+    command: "echo"
+    args: ["hello"]
+```