diff --git a/docs/api/hilbish/hilbish.messages.md b/docs/api/hilbish/hilbish.messages.md
new file mode 100644
index 0000000..2dff7a7
--- /dev/null
+++ b/docs/api/hilbish/hilbish.messages.md
@@ -0,0 +1,135 @@
+---
+title: Module hilbish.messages
+description: simplistic message passing
+layout: doc
+menu:
+ docs:
+ parent: "API"
+---
+
+
+## Introduction
+The messages interface defines a way for Hilbish-integrated commands,
+user config and other tasks to send notifications to alert the user.z
+The `hilbish.message` type is a table with the following keys:
+`title` (string): A title for the message notification.
+`text` (string): The contents of the message.
+`channel` (string): States the origin of the message, `hilbish.*` is reserved for Hilbish tasks.
+`summary` (string): A short summary of the `text`.
+`icon` (string): Unicode (preferably standard emoji) icon for the message notification
+`read` (boolean): Whether the full message has been read or not.
+
+## Functions
+|||
+|----|----|
+|unreadCount()|Returns the amount of unread messages.|
+|readAll()|Marks all messages as read.|
+|send(message)|Sends a message.|
+|read(idx)|Marks a message at `idx` as read.|
+|delete(idx)|Deletes the message at `idx`.|
+|clear()|Deletes all messages.|
+|all()|Returns all messages.|
+
+
+
+hilbish.messages.all()
+
+
+
+
+
+Returns all messages.
+#### Parameters
+This function has no parameters.
+
+
+
+hilbish.messages.clear()
+
+
+
+
+
+Deletes all messages.
+#### Parameters
+This function has no parameters.
+
+
+
+hilbish.messages.delete(idx)
+
+
+
+
+
+Deletes the message at `idx`.
+#### Parameters
+`idx` **`number`**
+
+
+
+
+
+hilbish.messages.read(idx)
+
+
+
+
+
+Marks a message at `idx` as read.
+#### Parameters
+`idx` **`number`**
+
+
+
+
+
+hilbish.messages.send(message)
+
+
+
+
+
+Sends a message.
+#### Parameters
+`message` **`hilbish.message`**
+
+
+
+
+
+hilbish.messages.readAll()
+
+
+
+
+
+Marks all messages as read.
+#### Parameters
+This function has no parameters.
+
+
+
+hilbish.messages.unreadCount()
+
+
+
+
+
+Returns the amount of unread messages.
+#### Parameters
+This function has no parameters.
+
@@ -114,3 +120,110 @@ This is the equivalent of using `source`.
+
+
+
+hilbish.runner.getCurrent()
+
+
+
+
+
+Returns the current runner by name.
+#### Parameters
+This function has no parameters.
+
+
+
+hilbish.runner.setCurrent(name)
+
+
+
+
+
+Sets Hilbish's runner mode by name.
+#### Parameters
+`name` **`string`**
+
+
+
+
+
+hilbish.runner.add(name, runner)
+
+
+
+
+
+Adds a runner to the table of available runners.
+If runner is a table, it must have the run function in it.
+#### Parameters
+`name` **`string`**
+ Name of the runner
+
+`runner` **`function|table`**
+
+
+
+
+
+hilbish.runner.get(name)
+
+
+
+
+
+Get a runner by name.
+#### Parameters
+`name` **`string`**
+ Name of the runner to retrieve.
+
+
+
+
+hilbish.runner.set(name, runner)
+
+
+
+
+
+*Sets* a runner by name. The difference between this function and
+add, is set will *not* check if the named runner exists.
+The runner table must have the run function in it.
+#### Parameters
+`name` **`string`**
+
+
+`runner` **`table`**
+
+
+
+
+
+hilbish.runner.exec(cmd, runnerName)
+
+
+
+
+
+Executes `cmd` with a runner.
+If `runnerName` is not specified, it uses the default Hilbish runner.
+#### Parameters
+`cmd` **`string`**
+
+
+`runnerName` **`string?`**
+
+
+