docs: tw cli

Author: faretek1

docs/tw-cli/index.md

@@ -0,0 +1,7 @@
+# [TW-CLI](https://github.com/inflated-goboscript/tw-cli)
+
+> Run scratch projects in the terminal
+
+- Uses playwright and turbowarp scaffolding
+- Supports the turbowarp debugger's log, warn, error and breakpoint blocks.
+- Supports exit codes with the `TW-CLI: exit code` variable **for all sprites**.

docs/tw-cli/installation.md

@@ -0,0 +1,12 @@
+# Installation
+
+`pip install turbowarp-cli`
+
+??? "Bleeding edge"
+
+    Install from source:
+
+    1. `git clone https://github.com/inflated-goboscript/tw-cli`
+    2. `cd tw-cli`
+    3. `pip install -e .`
+    4. to update, use `git pull`

docs/tw-cli/usage.md

@@ -0,0 +1,23 @@
+# Usage
+
+`twcli run` <Project path\>
+
+It only works on project files.
+
+---
+
+If you want to automatically supply inputs to `ask and wait` blocks, use the -i command:
+
+`twcli run .\Project.sb3 -i "hi" "there`
+
+This provides the arguments:
+- `hi`
+- `there`
+
+If you want to disable headless mode (to see the browser), use `-H`:
+
+`twcli run .\Project.sb3 -i "hi" "there" -H`
+
+If you want to raise an error if the exit code is not `'0'`, use `-R`:
+
+`twcli run .\Project.sb3 -i "hi" "there" -R`

mkdocs.yml

@@ -130,4 +130,9 @@ nav:
       - Usage:
         - Getting Started: inflator/usage/getting started.md
         - Installing Packages: inflator/usage/installing packages.md
-      - Other commands: inflator/other commands.md
+      - Other commands: inflator/other commands.md
+  - TW-CLI:
+      - TW-CLI: tw-cli/index.md
+      - Installation: tw-cli/installation.md
+      - Usage: tw-cli/usage.md
+