officedesk 0.0.14 → 0.0.18

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "officedesk",
-  "version": "0.0.14",
+  "version": "0.0.18",
   "description": "Master CLI for officedesk-ai — discovers and delegates to officedesk-plugin-* executables",
   "bin": {
     "officedesk": "bin/run.js"
@@ -12,8 +12,8 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@officedesk/linux-x64": "0.0.14",
-    "@officedesk/win32-x64": "0.0.14"
+    "@officedesk/linux-x64": "0.0.18",
+    "@officedesk/win32-x64": "0.0.18"
   },
   "scripts": {
     "build": "tsc",
@@ -33,10 +33,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"
   }
 }