How to Install OfficeCLI Using Homebrew: A Step-by-Step Guide

You can install OfficeCLI on macOS and Linux by adding the iofficeai/tap repository and running brew install officecli, which places the pre-built binary in your system path while respecting Homebrew's file management policies.

OfficeCLI, the command-line interface for the iOfficeAI/OfficeCLI repository, distributes official Homebrew support for streamlined macOS and Linux installation. When you install OfficeCLI using Homebrew, the package manager handles the pre-built binary placement instead of the tool's internal installer, ensuring clean upgrades and proper file isolation. This approach leverages Homebrew's Cellar structure to manage versions without conflicting with the CLI's automatic update mechanisms.

Installing OfficeCLI via Homebrew

The installation process requires two commands: one to register the custom tap and another to install the formula.

Add the Official Tap

First, register the iOfficeAI repository as a Homebrew tap:

brew tap iofficeai/tap

This downloads the formula definitions required to build and install OfficeCLI.

Install the Binary

Execute the install command to download and link the binary:

brew install officecli

Homebrew copies the pre-built binary into its Cellar directory (typically /opt/homebrew/Cellar/ on Apple Silicon or /usr/local/Cellar/ on Intel Macs) and creates a symlink in your local bin directory (/opt/homebrew/bin or /usr/local/bin).

Verify the Installation

Confirm the binary resolves correctly by checking its version:

officecli --version

A successful installation displays the current version number, such as officecli 1.4.2.

How Homebrew Integration Works

Unlike the standalone installer, the Homebrew-managed binary detects its package manager environment at runtime. In src/officecli/Core/Installer.cs (lines 15-22), the application checks for the presence of /Cellar/ or /Caskroom/ paths in its executable location. When detected, OfficeCLI skips the self-copy step and suppresses automatic update checks, preventing the tool from overwriting files managed by Homebrew's upgrade policy.

Upgrading OfficeCLI

To update to the latest release, use Homebrew's upgrade mechanism rather than the CLI's internal update command:

brew upgrade officecli

This ensures the old version remains in the Cellar until you run brew cleanup, maintaining atomic upgrades that can be rolled back if necessary.

Summary

• Add the tap: Run brew tap iofficeai/tap once to register the repository.
• Install: Use brew install officecli to place the binary in your system path.
• Detection logic: The runtime checks src/officecli/Core/Installer.cs to detect Homebrew-managed installations and disables self-updates.
• Upgrade path: Always use brew upgrade officecli to update versions.

Frequently Asked Questions

Does OfficeCLI support Apple Silicon (M1/M2) Macs via Homebrew?

Yes. The Homebrew formula automatically selects the correct architecture for Apple Silicon or Intel Macs. On Apple Silicon systems, the binary installs to /opt/homebrew/bin, while Intel systems use /usr/local/bin.

Why does OfficeCLI disable automatic updates when installed via Homebrew?

The tool detects its installation context in src/officecli/Core/Installer.cs by checking for Cellar or Caskroom directories. When found, it respects Homebrew's file management by suppressing self-updates, preventing conflicts with the package manager's version control.

Can I install OfficeCLI without adding the tap?

No. OfficeCLI is distributed through a custom tap (iofficeai/tap) rather than the official Homebrew core repository. You must run brew tap iofficeai/tap before installing to access the formula.

How do I uninstall OfficeCLI if I installed it via Homebrew?

Run brew uninstall officecli to remove the binary and symlinks. If you also want to remove the tap definition, execute brew untap iofficeai/tap.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}