officedesk

Master CLI for OfficeDesk AI. Discovers and delegates to officedesk-plugin-* executables in $PATH using the Git-style delegation pattern.

Installation

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

# 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

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:

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 |

officedesk sheets append-row --spreadsheet-id=ID --sheet=Sheet1 --data='{"Name":"John"}'

Global commands

--help

Show aggregated help output from all discovered plugins.

officedesk --help

--list

List all discovered plugins and their binary paths.

officedesk --list

list-profiles

Aggregate and display configured profiles across all profile-aware plugins (plugin-aws, plugin-gmail, plugin-google-drive, plugin-slack).

officedesk list-profiles

Returns JSON with profiles from each plugin that supports the list-profiles command.

--version

Print the CLI version.

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:

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

This project is licensed under a proprietary End User License Agreement (EULA). See the LICENSE file for details.