Skip to content
Back to search

officecli

OfficeCLI is AI document generation CLI for PPTX, DOCX, XLSX, Reports, and Images. Generate editable Office files from prompts with npm install, hosted trial, and optional agent skills.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/officecli--officecli/badge.svg)](/listings/officecli--officecli)

HTML

<a href="/listings/officecli--officecli"><img src="/api/listings/officecli--officecli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

npm is the recommended install path for most users:

npm install -g officecli

Verify the installed binary:

officecli --version
officecli auth status

Alternative install paths are available when npm is not a good fit.

Install the latest release binary directly:

curl -fsSL https://raw.githubusercontent.com/officecli/officecli-dist/main/scripts/install-officecli.sh | bash

Or install with Homebrew:

brew tap officecli/officecli
brew install officecli

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 22 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "officecli",
  3. "owner": {
  4. "name": "officecli"
  5. },
  6. "metadata": {
  7. "description": "OfficeCLI skills marketplace for Claude Code PPTX, DOCX, XLSX, and report workflows",
  8. "version": "0.1.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "officecli",
  13. "source": "./plugins/officecli",
  14. "description": "Office document skill for PPTX, DOCX, XLSX, and report workflows"
  15. },
  16. {
  17. "name": "openclaw-officecli",
  18. "source": "./plugins/openclaw-officecli",
  19. "description": "OpenClaw-oriented OfficeCLI integration skill"
  20. }
  21. ]
  22. }
README.md · README · 318 lines · 5 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # OfficeDex is the AI-native document workspace, powered by OfficeCLI
  2. [![OfficeDex](https://img.shields.io/badge/try-OfficeDex.ai-5645d4)](https://officedex.ai)
  3. [![GitHub Release](https://img.shields.io/github/v/release/officecli/officecli-dist?label=release)](https://github.com/officecli/officecli-dist/releases)
  4. [![npm](https://img.shields.io/npm/v/officecli?label=npm)](https://www.npmjs.com/package/officecli)
  5. [![License](https://img.shields.io/github/license/officecli/officecli)](./LICENSE)
  6. [![Discord](https://img.shields.io/badge/community-Discord-5865F2)](https://discord.gg/ezAHMkdG)
  7. [![X](https://img.shields.io/badge/follow-%40officecli-000000?logo=x)](https://x.com/officecli)
  8. Create, edit, and manage AI-generated `PPTX`, `DOCX`, `XLSX`, reports, and images with
  9. [OfficeDex](https://officedex.ai) — the easiest way to experience everything OfficeCLI can do.
  10. OfficeCLI is a command-line tool that turns natural-language prompts into editable Office files and
  11. standalone images from a terminal, script, CI job, or local automation flow. Use one `officecli` binary
  12. to generate `PPTX`, `DOCX`, `XLSX`, workbook-backed `Report`, and `img` outputs, with hosted trial access
  13. for first runs and External Mode when you want to bring your own LLM endpoint.
  14. Chinese documentation: [README.zh-CN.md](./README.zh-CN.md)
  15. - Get OfficeDex: [officedex.ai](https://officedex.ai)
  16. - Demo gallery: [demos/README.md](./demos/README.md)
  17. - Optional agent skills: [Claude Code](./claude-code/README.md), [Codex](./codex/README.md), [OpenClaw](./openclaw/README.md)
  18. - OfficeCLI website: [officecli.io/officecli](https://officecli.io/officecli)
  19. - Community: [Discord](https://discord.gg/ezAHMkdG)
  20. ## Install in one command
  21. npm is the recommended install path for most users:
  22. ```bash
  23. npm install -g officecli
  24. ```
  25. Verify the installed binary:
  26. ```bash
  27. officecli --version
  28. officecli auth status
  29. ```
  30. Alternative install paths are available when npm is not a good fit.
  31. Install the latest release binary directly:
  32. ```bash
  33. curl -fsSL https://raw.githubusercontent.com/officecli/officecli-dist/main/scripts/install-officecli.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 46 on GitHub
  34. ```
  35. Or install with Homebrew:
  36. ```bash
  37. brew tap officecli/officecli
  38. brew install officecli
  39. ```
  40. ## Generate files from the CLI
  41. Hosted anonymous trial access is available by default, so the first run does not require a local model
  42. endpoint or API key.
  43. Generate a PPTX deck:
  44. ```bash
  45. officecli new pptx "Q3 Business Review" --prompt "Create a six-slide executive deck for a SaaS quarterly business review. Cover growth, retention, risks, and next-quarter actions."
  46. ```
  47. Generate a DOCX:
  48. ```bash
  49. officecli new docx "Product Launch Brief" --prompt "Write a concise launch brief with audience, positioning, timeline, risks, and next steps."
  50. ```
  51. Generate an XLSX workbook:
  52. ```bash
  53. officecli new xlsx "Sales Pipeline" --prompt "Create a sales pipeline workbook with stages, owners, deal values, probability, and next action columns."
  54. ```
  55. Generate a workbook-backed report:
  56. ```bash
  57. officecli new report "Q2 Business Review" --file ./data/q2_metrics.xlsx --prompt "Summarize regional revenue shifts and the board-level decision points."
  58. ```
  59. Generate a standalone image:
  60. ```bash
  61. officecli new img "Launch Visual" --prompt "Create a polished product launch hero image for an enterprise collaboration platform." --ratio landscape --reference-image ./reference.png
  62. ```
  63. Generated files are written to `./output` by default. Use `--out <dir>` to choose another directory,
  64. `--json` for machine-readable output, and `--no-publish` when you want local-only output.
  65. For `PPTX`, OfficeCLI generates and embeds suitable images by default. Use `--no-images` for a
  66. text-only deck.
  67. ## What OfficeCLI is best for
  68. | Search intent | OfficeCLI capability |
  69. | --- | --- |
  70. | AI PPTX generator | Create editable PowerPoint decks from prompts, with images by default and `--no-images` for text-only decks. |
  71. | DOCX generator CLI | Draft editable Word documents for briefs, memos, proposals, and customer-facing documents. |
  72. | XLSX automation | Generate workbooks, trackers, dashboards, and analysis sheets from structured prompts. |
  73. | Report generation | Use an existing workbook as evidence and generate a readable workbook-backed report. |
  74. | Image generation CLI | Generate standalone `img` outputs with `--ratio square\|landscape\|portrait` and optional reference images. |
  75. | Local-first document automation | Run from a terminal, script, CI job, or agent workflow with one installable binary. |
  76. ## Runtime and access modes
  77. Check the current access mode:
  78. ```bash
  79. officecli auth status
  80. ```
  81. When the hosted trial is used up, create or purchase a hosted key from https://officecli.io/pricing,
  82. then save it:
  83. ```bash
  84. officecli auth set-key <api-key>
  85. ```
  86. To use your own model endpoint instead of Hosted Mode, switch to External Mode and initialize
  87. generation:
  88. ```bash
  89. officecli config set-runtime external
  90. officecli config set-generation
  91. ```
  92. Configure optional online publishing:
  93. ```bash
  94. officecli config set-publish
  95. ```
  96. Inspect the current config:
  97. ```bash
  98. officecli config status
  99. ```
  100. ## What the binary supports
  101. The `officecli` binary supports:
  102. - AI PPTX generation for decks, proposals, and executive briefings
  103. - AI DOCX drafting for retrospectives, memos, and customer-facing documents
  104. - AI XLSX generation for workbooks, trackers, and analysis sheets
  105. - workbook-backed reports
  106. - standalone image generation with `--ratio square|landscape|portrait`
  107. - optional reference images for standalone `img` output
  108. - local-only generation with `--no-publish`
  109. - structural PPTX scoring with `officecli score pptx <file>`
  110. The compatibility alias remains available:
  111. ```bash
  112. officecli review pptx ./output/Enterprise-Collaboration-Platform.pptx
  113. ```
  114. ## Generation demos
  115. These checked-in demos show the visible result and the reproducible inputs together. Each demo includes
  116. a preview image, the generated artifact, `prompt.md`, `metadata.json`, and the command used to reproduce
  117. the flow with a configured OfficeCLI runtime.
  118. | AI PPTX, DOCX, XLSX, report, and image demos | Preview | Files |
  119. | --- | --- | --- |
  120. | AI PPTX generator with images | ![AI PPTX generator preview created by OfficeCLI](./demos/pptx-image-rich/preview.png) | [PPTX](./demos/pptx-image-rich/image-rich-strategy-deck.pptx) · [Prompt](./demos/pptx-image-rich/prompt.md) · [Metadata](./demos/pptx-image-rich/metadata.json) |
  121. | Text-only AI PPTX generator | ![Text-only AI PPTX generator preview created by OfficeCLI](./demos/pptx-text-only/preview.png) | [PPTX](./demos/pptx-text-only/text-only-executive-briefing.pptx) · [Prompt](./demos/pptx-text-only/prompt.md) · [Metadata](./demos/pptx-text-only/metadata.json) |
  122. | DOCX generator CLI | ![DOCX generator CLI preview created by OfficeCLI](./demos/docx-brief/preview.png) | [DOCX](./demos/docx-brief/officecli-customer-brief.docx) · [Prompt](./demos/docx-brief/prompt.md) · [Metadata](./demos/docx-brief/metadata.json) |
  123. | XLSX automation dashboard | ![XLSX automation preview created by OfficeCLI](./demos/xlsx-dashboard/preview.png) | [XLSX](./demos/xlsx-dashboard/demo-adoption-dashboard.xlsx) · [Prompt](./demos/xlsx-dashboard/prompt.md) · [Metadata](./demos/xlsx-dashboard/metadata.json) |
  124. | Workbook-backed report generation | ![Report generation preview created by OfficeCLI](./demos/report-workbook/preview.png) | [HTML report](./demos/report-workbook/demo-program-readiness-report.html) · [Source XLSX](./demos/report-workbook/demo-program-source-workbook.xlsx) · [Prompt](./demos/report-workbook/prompt.md) |
  125. | Image generation CLI | ![Image generation CLI preview created by OfficeCLI](./demos/standalone-img/preview.png) | [PNG](./demos/standalone-img/officecli-hero-image.png) · [Prompt](./demos/standalone-img/prompt.md) · [Metadata](./demos/standalone-img/metadata.json) |
  126. See [demos/README.md](./demos/README.md) for the complete reproducibility table and verification notes.
  127. ## Optional AI agent integrations
  128. AI agents can use OfficeCLI through public skills when you want the agent to route Office tasks into the
  129. local binary instead of calling the CLI manually. This is optional: the primary interface is still the
  130. `officecli` command.
  131. ### Claude Code
  132. OfficeCLI can be installed directly by Claude Code from the marketplace source.
  133. OfficeCLI marketplace source:
  134. ```text
  135. /plugin marketplace add officecli/officecli
  136. ```
  137. Install the primary plugin:
  138. ```text
  139. /plugin install officecli@officecli
  140. ```
  141. ### Codex and other local agents
  142. Use the direct installer when you want the public skill files without marketplace installation.
  143. Use `wget`:
  144. ```bash
  145. wget -qO- https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-skill.sh | bash -s -- officecli
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 208 on GitHub
  146. ```
  147. Or use `curl`:
  148. ```bash
  149. curl -fsSL https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-skill.sh | bash -s -- officecli
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 214 on GitHub
  150. ```
  151. If you only want the skill and do not want to auto-install the binary:
  152. ```bash
  153. curl -fsSL https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-skill.sh | AUTO_INSTALL_BINARY=0 bash -s -- officecli
  154. ```
  155. ### OpenClaw
  156. If you want OpenClaw users to generate local Office files directly from Telegram, Discord, Slack, or
  157. other channels, install the OpenClaw-facing skill package.
  158. Use `wget`:
  159. ```bash
  160. wget -qO- https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-openclaw-skill.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 231 on GitHub
  161. ```
  162. Or use `curl`:
  163. ```bash
  164. curl -fsSL https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-openclaw-skill.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 237 on GitHub
  165. ```
  166. The OpenClaw installer will:
  167. - install `openclaw-officecli` into `~/.openclaw/skills`
  168. - create `config.yaml` from `config.example.yaml` when needed
  169. - try to auto-install the `officecli` binary when it is missing
  170. If you only want the OpenClaw skill and do not want to auto-install the binary:
  171. ```bash
  172. curl -fsSL https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-openclaw-skill.sh | AUTO_INSTALL_BINARY=0 bash
  173. ```
  174. ## Requirements
  175. - a local `officecli` binary
  176. - OfficeCLI access through hosted trial, hosted key, or External Mode configuration
  177. - optional publishing configuration when you want online preview URLs
  178. - for agent integrations, permission for the agent client to invoke local commands on the same machine
  179. Quick verification after installation:
  180. ```bash
  181. officecli --version
  182. officecli config status
  183. ```
  184. For OpenClaw, also verify:
  185. ```bash
  186. officecli agent-bridge
  187. ```
  188. ## OfficeCLI and officecli fit together
  189. - `officecli` is the command-line binary you use to generate Office files and images
  190. - this repository is the public install, docs, demos, and integration surface for that binary
  191. - `officecli` is also the general optional skill for Claude Code, Codex, and other local agents
  192. - `openclaw-officecli` is the OpenClaw-oriented package
  193. ## FAQ
  194. ### Is this repository a hosted SaaS plugin backend?
  195. No. This repository distributes binary install docs, demos, scripts, and optional local skill wrappers.
  196. ### Does the CLI require an AI agent?
  197. No. The main workflow is direct CLI usage through commands like `officecli new pptx`, `officecli new
  198. docx`, `officecli new xlsx`, `officecli new report`, and `officecli new img`.
  199. ### Can AI agents create PPTX, DOCX, XLSX, report, or img outputs with this repository?
  200. Yes, when the local `officecli` runtime is installed and configured. The repository tells the agent how
  201. to route supported Office and image tasks into the local OfficeCLI binary.
  202. ### Why does this repository mention Codex as well as Claude Code?
  203. Because marketplace install is only one entrypoint. This repository also distributes direct skill files
  204. for Codex-style local agents and other agent runtimes.
  205. ### Does this repository contain the full OfficeCLI implementation?
  206. No. It contains public install docs, demos, scripts, skill definitions, and plugin wrappers.
  207. ## Layout
  208. - `install/README.md`: install entrypoint for search and onboarding
  209. - `claude-code/README.md`: Claude Code marketplace install guide
  210. - `codex/README.md`: direct local install guide for Codex-style agents
  211. - `openclaw/README.md`: OpenClaw installer and bridge guide
  212. - `faq/README.md`: FAQ entrypoint
  213. - `.claude-plugin/marketplace.json`: Claude Code marketplace definition
  214. - `demos/`: reproducible demo gallery with preview images, prompts, metadata, and generated files
  215. - `plugins/officecli/`: Claude Code plugin wrapper for the `officecli` skill
  216. - `plugins/openclaw-officecli/`: Claude Code plugin wrapper for the `openclaw-officecli` skill
  217. - `skills/officecli/`: public OfficeCLI skill definition
  218. - `skills/openclaw-officecli/`: public OpenClaw skill definition
  219. - `scripts/install-skill.sh`: shell installer for direct `wget` / `curl` usage
  220. - `scripts/install-openclaw-skill.sh`: shell installer for OpenClaw users

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.