officedesk 0.0.15 → 0.0.19

package/README.md

@@ -0,0 +1,149 @@
+# officedesk
+
+Master CLI for [OfficeDesk AI](https://github.com/initdsg/officedesk.ai). Discovers and delegates to `officedesk-plugin-*` executables in `$PATH` using the Git-style delegation pattern.
+
+## Installation
+
+```bash
+npm install -g officedesk
+```
+
+## How it works
+
+The `officedesk` CLI scans `$PATH` for executables matching the `officedesk-plugin-*` naming convention and delegates commands to them:
+
+```
+officedesk <plugin> <command> [options]
+```
+
+This means you can install any OfficeDesk plugin globally and use it immediately through the master CLI without any additional configuration.
+
+## Quick start
+
+```bash
+# Install the CLI and a plugin
+npm install -g officedesk @officedesk/plugin-gmail
+
+# Delegate a command to the plugin
+officedesk plugin-gmail search-messages --query="subject:invoice"
+
+# List all discovered plugins
+officedesk --list
+
+# Show aggregated help from all discovered plugins
+officedesk --help
+```
+
+## Usage
+
+```
+officedesk <plugin> <command> [options]
+officedesk --help
+officedesk --list
+officedesk list-profiles
+```
+
+### Delegate to a plugin
+
+```bash
+officedesk plugin-jira get-ticket --issue=PROJ-123
+officedesk plugin-xero get-accounts
+officedesk plugin-gmail search-messages --query="from:boss"
+officedesk plugin-slack send-message --text="Build complete"
+officedesk plugin-google-drive list-files --folder-path=Finance
+officedesk plugin-odoo list-invoices
+```
+
+The plugin name can be passed with or without the `plugin-` prefix:
+
+```bash
+officedesk plugin-gmail search-messages --query="subject:invoice"
+officedesk gmail search-messages --query="subject:invoice"   # same thing
+```
+
+### Plugin aliases
+
+Some plugins have short aliases:
+
+| Alias | Resolves to |
+|---|---|
+| `sheets` | `plugin-google-sheets` |
+| `google-sheets` | `plugin-google-sheets` |
+| `plugin-sheets` | `plugin-google-sheets` |
+
+```bash
+officedesk sheets append-row --spreadsheet-id=ID --sheet=Sheet1 --data='{"Name":"John"}'
+```
+
+## Global commands
+
+### `--help`
+
+Show aggregated help output from all discovered plugins.
+
+```bash
+officedesk --help
+```
+
+### `--list`
+
+List all discovered plugins and their binary paths.
+
+```bash
+officedesk --list
+```
+
+### `list-profiles`
+
+Aggregate and display configured profiles across all profile-aware plugins (`plugin-aws`, `plugin-gmail`, `plugin-google-drive`, `plugin-slack`).
+
+```bash
+officedesk list-profiles
+```
+
+Returns JSON with profiles from each plugin that supports the `list-profiles` command.
+
+### `--version`
+
+Print the CLI version.
+
+```bash
+officedesk --version
+```
+
+## Plugin discovery
+
+The CLI scans the following locations for `officedesk-plugin-*` executables, in order:
+
+1. All directories in `$PATH`
+2. `./dist/bin/` relative to the current working directory
+3. The directory containing the `officedesk` binary itself
+
+The first matching executable found for each plugin name wins. Platform-specific variants (e.g. `officedesk-plugin-gmail-linux`) and `.exe` suffixes are handled automatically.
+
+## Installing plugins
+
+Each OfficeDesk plugin is a separate npm package. Install the ones you need globally alongside the CLI:
+
+```bash
+npm install -g officedesk \
+  @officedesk/plugin-gmail \
+  @officedesk/plugin-slack \
+  @officedesk/plugin-google-drive \
+  @officedesk/plugin-jira \
+  @officedesk/plugin-xero
+```
+
+Once installed, they are automatically discovered the next time you run `officedesk`.
+
+## Environment variables
+
+| Variable | Description |
+|---|---|
+| `OFFICEDESK_HOME` | Base directory for plugin config and tokens (default: `~/.officedesk/`) |
+
+`OFFICEDESK_HOME` is passed through to each plugin binary when commands are delegated.
+
+## License
+
+ISC

package/bin/run.js

@@ -12,10 +12,12 @@ function getPlatformPkg() {
 
     if (platform === 'win32' && arch === 'x64') return '@officedesk/win32-x64';
     if (platform === 'linux' && arch === 'x64') return '@officedesk/linux-x64';
+    if (platform === 'darwin' && arch === 'x64') return '@officedesk/darwin-x64';
+    if (platform === 'darwin' && arch === 'arm64') return '@officedesk/darwin-arm64';
 
     throw new Error(
         `officedesk: unsupported platform ${platform}/${arch}. ` +
-            `Supported: linux/x64, win32/x64.`
+            `Supported: linux/x64, win32/x64, darwin/x64, darwin/arm64.`
     );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "officedesk",
-  "version": "0.0.15",
+  "version": "0.0.19",
   "description": "Master CLI for officedesk-ai — discovers and delegates to officedesk-plugin-* executables",
   "bin": {
     "officedesk": "bin/run.js"
@@ -12,8 +12,10 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@officedesk/linux-x64": "0.0.15",
-    "@officedesk/win32-x64": "0.0.15"
+    "@officedesk/linux-x64": "0.0.19",
+    "@officedesk/win32-x64": "0.0.19",
+    "@officedesk/darwin-x64": "0.0.19",
+    "@officedesk/darwin-arm64": "0.0.19"
   },
   "scripts": {
     "build": "tsc",
@@ -21,7 +23,9 @@
     "test": "tsc && node --test dist/__tests__/*.test.js",
     "build:bin": "bun build src/index.ts --compile --outfile ../../dist/bin/officedesk",
     "build:bin:linux": "bun build src/index.ts --compile --target=bun-linux-x64 --outfile ../../dist/bin/officedesk-linux",
-    "build:bin:windows": "bun build src/index.ts --compile --target=bun-windows-x64 --outfile ../../dist/bin/officedesk.exe"
+    "build:bin:windows": "bun build src/index.ts --compile --target=bun-windows-x64 --outfile ../../dist/bin/officedesk.exe",
+    "build:bin:macos-x64": "bun build src/index.ts --compile --target=bun-darwin-x64 --outfile ../../dist/bin/officedesk-darwin-x64",
+    "build:bin:macos-arm64": "bun build src/index.ts --compile --target=bun-darwin-arm64 --outfile ../../dist/bin/officedesk-darwin-arm64"
   },
   "keywords": [
     "officedesk",
@@ -33,10 +37,5 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/initdsg/officedesk.ai-cli.git"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/node": "^25.0.10",
-    "typescript": "^5.9.3"
   }
 }