docs: improve documentation coverage (closes #119)

- Add tabbed content support for OS-specific instructions
- Add shell completions section to getting-started.md
- Document --compile-bytecode and --output-format in bundling.md
- Fix outdated bytecode compilation statement in limitations.md
- Add -R alias for --recursive in cli.md
- Add JSON output section to fs-commands.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: metaist

docs/bundling.md

@@ -82,6 +82,35 @@ uvx cosmofy bundle --python-url https://example.com/custom-python
 
 Or set `COSMOFY_PYTHON_URL` environment variable.
 
+## Bytecode Compilation
+
+Compile Python files to bytecode (`.pyc`) for faster startup:
+
+```bash
+uvx cosmofy bundle --compile-bytecode
+```
+
+This uses the Cosmopolitan Python in the bundle to compile `.py` files. The trade-off is slightly larger bundle size for faster initial import times.
+
+## Output Format
+
+Get structured JSON output instead of text:
+
+```bash
+uvx cosmofy bundle --output-format json
+```
+
+The JSON output includes paths to all generated bundles:
+
+```json
+{
+  "entry_points": ["dist/my_command"],
+  "scripts": []
+}
+```
+
+This is useful for scripting and CI/CD pipelines.
+
 ## Dry Run
 
 See what would happen without making changes:

docs/cli.md

@@ -387,7 +387,7 @@ Arguments:
 
 Options:
   -f, --force               ignore nonexistent files
-  -r, --recursive           recursively remove directories
+  -r, -R, --recursive       recursively remove directories
 
 Global options:
   -h, --help                show this help message

docs/fs-commands.md

@@ -125,3 +125,23 @@ uvx cosmofy fs args my_bundle '-m my_module'
 ```
 
 See [.args File](args-file.md) for more details.
+
+## JSON Output
+
+All `fs` commands support `--output-format json` for structured output:
+
+```bash
+# List files as JSON
+uvx cosmofy fs ls my_bundle --output-format json
+
+# Get file contents as JSON
+uvx cosmofy fs cat my_bundle .args --output-format json
+
+# Track what was added
+uvx cosmofy fs add my_bundle file.py --output-format json
+
+# Track what was removed
+uvx cosmofy fs rm my_bundle old.py --output-format json
+```
+
+This is useful for scripting and parsing results programmatically.

docs/getting-started.md

@@ -30,21 +30,55 @@ pip install cosmofy
 
 You can also download the `cosmofy` binary directly.
 
-**macOS / Linux:**
+=== "macOS / Linux"
 
-```bash
-dest=~/.local/bin/cosmofy
-curl -sSz $dest -o $dest -L https://github.com/metaist/cosmofy/releases/latest/download/cosmofy
-chmod +x $dest
-```
+    ```bash
+    dest=~/.local/bin/cosmofy
+    curl -sSz $dest -o $dest -L https://github.com/metaist/cosmofy/releases/latest/download/cosmofy
+    chmod +x $dest
+    ```
 
-**Windows:**
+=== "Windows"
 
-```powershell
-$dest = "$env:LOCALAPPDATA\cosmofy\cosmofy.exe"
-New-Item -ItemType Directory -Force -Path (Split-Path $dest)
-Invoke-WebRequest -Uri "https://github.com/metaist/cosmofy/releases/latest/download/cosmofy" -OutFile $dest
-```
+    ```powershell
+    $dest = "$env:LOCALAPPDATA\cosmofy\cosmofy.exe"
+    New-Item -ItemType Directory -Force -Path (Split-Path $dest)
+    Invoke-WebRequest -Uri "https://github.com/metaist/cosmofy/releases/latest/download/cosmofy" -OutFile $dest
+    ```
+
+### Shell Completions
+
+Enable tab completion for your shell:
+
+=== "Bash"
+
+    Add to `~/.bashrc`:
+
+    ```bash
+    eval "$(cosmofy completions bash)"
+    ```
+
+=== "Zsh"
+
+    Add to `~/.zshrc`:
+
+    ```zsh
+    eval "$(cosmofy completions zsh)"
+    ```
+
+    Or save to your fpath:
+
+    ```zsh
+    cosmofy completions zsh > ~/.zfunc/_cosmofy
+    ```
+
+=== "Fish"
+
+    Save to completions directory:
+
+    ```fish
+    cosmofy completions fish > ~/.config/fish/completions/cosmofy.fish
+    ```
 
 ## Quick Example
 

docs/limitations.md

@@ -26,9 +26,13 @@ Custom Python versions are not currently supported. See [#44](https://github.com
 
 ## Bytecode Compilation
 
-Automatic Python bytecode compilation (`.pyc` files) is currently disabled.
+Bytecode compilation (`.pyc` files) is available but not enabled by default. Use `--compile-bytecode` to enable it:
 
-See [#41](https://github.com/metaist/cosmofy/issues/41).
+```bash
+uvx cosmofy bundle --compile-bytecode
+```
+
+This trades slightly larger bundle size for faster import times.
 
 ## Platform-Specific Features
 

mkdocs.yml

@@ -30,6 +30,7 @@ theme:
     - search.suggest
     - search.highlight
     - content.code.copy
+    - content.tabs.link
 
 nav:
   - Home: index.md
@@ -48,6 +49,8 @@ markdown_extensions:
   - pymdownx.highlight:
       anchor_linenums: true
   - pymdownx.inlinehilite
+  - pymdownx.tabbed:
+      alternate_style: true
   - toc:
       permalink: true