{"id":50430485,"url":"https://github.com/officecli/officecli","last_synced_at":"2026-05-31T14:01:23.794Z","repository":{"id":348534041,"uuid":"1198229219","full_name":"officecli/officecli","owner":"officecli","description":"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.","archived":false,"fork":false,"pushed_at":"2026-05-22T02:15:24.000Z","size":2562,"stargazers_count":38,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T11:43:14.009Z","etag":null,"topics":["ai","ai-agents","ai-document-generator","automation","claude-code","cli","codex","developer-tools","document-automation","docx","image-generation","local-first","npm","office-documents","officecli","openclaw","powerpoint","pptx","report-generation","xlsx"],"latest_commit_sha":null,"homepage":"https://officecli.io","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/officecli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-01T08:24:42.000Z","updated_at":"2026-05-22T02:15:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/officecli/officecli","commit_stats":null,"previous_names":["officecli/office-cli-skills","officecli/officecli-skills","officecli/officecli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/officecli/officecli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officecli%2Fofficecli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officecli%2Fofficecli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officecli%2Fofficecli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officecli%2Fofficecli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/officecli","download_url":"https://codeload.github.com/officecli/officecli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/officecli%2Fofficecli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33733754,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-document-generator","automation","claude-code","cli","codex","developer-tools","document-automation","docx","image-generation","local-first","npm","office-documents","officecli","openclaw","powerpoint","pptx","report-generation","xlsx"],"created_at":"2026-05-31T14:01:23.215Z","updated_at":"2026-05-31T14:01:23.788Z","avatar_url":"https://github.com/officecli.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OfficeCLI is an AI document generation CLI for PPTX, DOCX, XLSX, reports, and images\n\n[![GitHub Release](https://img.shields.io/github/v/release/officecli/officecli-dist?label=release)](https://github.com/officecli/officecli-dist/releases)\n[![npm](https://img.shields.io/npm/v/officecli?label=npm)](https://www.npmjs.com/package/officecli)\n[![License](https://img.shields.io/github/license/officecli/officecli)](./LICENSE)\n[![Website](https://img.shields.io/badge/website-officecli.io-0f766e)](https://officecli.io/officecli)\n[![Discord](https://img.shields.io/badge/community-Discord-5865F2)](https://discord.gg/ezAHMkdG)\n[![X](https://img.shields.io/badge/follow-%40officecli-000000?logo=x)](https://x.com/officecli)\n\nOfficeCLI is a command-line tool that turns natural-language prompts into editable Office files and\nstandalone images from a terminal, script, CI job, or local automation flow. Use one `officecli` binary\nto generate `PPTX`, `DOCX`, `XLSX`, workbook-backed `Report`, and `img` outputs, with hosted trial access\nfor first runs and External Mode when you want to bring your own LLM endpoint.\n\nChinese documentation: [README.zh-CN.md](./README.zh-CN.md)\n\n- Website: [officecli.io/officecli](https://officecli.io/officecli)\n- Demo gallery: [demos/README.md](./demos/README.md)\n- Optional agent skills: [Claude Code](./claude-code/README.md), [Codex](./codex/README.md), [OpenClaw](./openclaw/README.md)\n- Community: [Discord](https://discord.gg/ezAHMkdG)\n\n## Install in one command\n\nnpm is the recommended install path for most users:\n\n```bash\nnpm install -g officecli\n```\n\nVerify the installed binary:\n\n```bash\nofficecli --version\nofficecli auth status\n```\n\nAlternative install paths are available when npm is not a good fit.\n\nInstall the latest release binary directly:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/officecli/officecli-dist/main/scripts/install-officecli.sh | bash\n```\n\nOr install with Homebrew:\n\n```bash\nbrew tap officecli/officecli\nbrew install officecli\n```\n\n## Generate files from the CLI\n\nHosted anonymous trial access is available by default, so the first run does not require a local model\nendpoint or API key.\n\nGenerate a PPTX deck:\n\n```bash\nofficecli 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.\"\n```\n\nGenerate a DOCX:\n\n```bash\nofficecli new docx \"Product Launch Brief\" --prompt \"Write a concise launch brief with audience, positioning, timeline, risks, and next steps.\"\n```\n\nGenerate an XLSX workbook:\n\n```bash\nofficecli new xlsx \"Sales Pipeline\" --prompt \"Create a sales pipeline workbook with stages, owners, deal values, probability, and next action columns.\"\n```\n\nGenerate a workbook-backed report:\n\n```bash\nofficecli new report \"Q2 Business Review\" --file ./data/q2_metrics.xlsx --prompt \"Summarize regional revenue shifts and the board-level decision points.\"\n```\n\nGenerate a standalone image:\n\n```bash\nofficecli new img \"Launch Visual\" --prompt \"Create a polished product launch hero image for an enterprise collaboration platform.\" --ratio landscape --reference-image ./reference.png\n```\n\nGenerated files are written to `./output` by default. Use `--out \u003cdir\u003e` to choose another directory,\n`--json` for machine-readable output, and `--no-publish` when you want local-only output.\n\nFor `PPTX`, OfficeCLI generates and embeds suitable images by default. Use `--no-images` for a\ntext-only deck.\n\n## What OfficeCLI is best for\n\n| Search intent | OfficeCLI capability |\n| --- | --- |\n| AI PPTX generator | Create editable PowerPoint decks from prompts, with images by default and `--no-images` for text-only decks. |\n| DOCX generator CLI | Draft editable Word documents for briefs, memos, proposals, and customer-facing documents. |\n| XLSX automation | Generate workbooks, trackers, dashboards, and analysis sheets from structured prompts. |\n| Report generation | Use an existing workbook as evidence and generate a readable workbook-backed report. |\n| Image generation CLI | Generate standalone `img` outputs with `--ratio square\\|landscape\\|portrait` and optional reference images. |\n| Local-first document automation | Run from a terminal, script, CI job, or agent workflow with one installable binary. |\n\n## Runtime and access modes\n\nCheck the current access mode:\n\n```bash\nofficecli auth status\n```\n\nWhen the hosted trial is used up, create or purchase a hosted key from https://officecli.io/pricing,\nthen save it:\n\n```bash\nofficecli auth set-key \u003capi-key\u003e\n```\n\nTo use your own model endpoint instead of Hosted Mode, switch to External Mode and initialize\ngeneration:\n\n```bash\nofficecli config set-runtime external\nofficecli config set-generation\n```\n\nConfigure optional online publishing:\n\n```bash\nofficecli config set-publish\n```\n\nInspect the current config:\n\n```bash\nofficecli config status\n```\n\n## What the binary supports\n\nThe `officecli` binary supports:\n\n- AI PPTX generation for decks, proposals, and executive briefings\n- AI DOCX drafting for retrospectives, memos, and customer-facing documents\n- AI XLSX generation for workbooks, trackers, and analysis sheets\n- workbook-backed reports\n- standalone image generation with `--ratio square|landscape|portrait`\n- optional reference images for standalone `img` output\n- local-only generation with `--no-publish`\n- structural PPTX scoring with `officecli score pptx \u003cfile\u003e`\n\nThe compatibility alias remains available:\n\n```bash\nofficecli review pptx ./output/Enterprise-Collaboration-Platform.pptx\n```\n\n## Generation demos\n\nThese checked-in demos show the visible result and the reproducible inputs together. Each demo includes\na preview image, the generated artifact, `prompt.md`, `metadata.json`, and the command used to reproduce\nthe flow with a configured OfficeCLI runtime.\n\n| AI PPTX, DOCX, XLSX, report, and image demos | Preview | Files |\n| --- | --- | --- |\n| 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) |\n| 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) |\n| 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) |\n| 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) |\n| 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) |\n| 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) |\n\nSee [demos/README.md](./demos/README.md) for the complete reproducibility table and verification notes.\n\n## Optional AI agent integrations\n\nAI agents can use OfficeCLI through public skills when you want the agent to route Office tasks into the\nlocal binary instead of calling the CLI manually. This is optional: the primary interface is still the\n`officecli` command.\n\n### Claude Code\n\nOfficeCLI can be installed directly by Claude Code from the marketplace source.\n\nOfficeCLI marketplace source:\n\n```text\n/plugin marketplace add officecli/officecli\n```\n\nInstall the primary plugin:\n\n```text\n/plugin install officecli@officecli\n```\n\n### Codex and other local agents\n\nUse the direct installer when you want the public skill files without marketplace installation.\n\nUse `wget`:\n\n```bash\nwget -qO- https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-skill.sh | bash -s -- officecli\n```\n\nOr use `curl`:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-skill.sh | bash -s -- officecli\n```\n\nIf you only want the skill and do not want to auto-install the binary:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-skill.sh | AUTO_INSTALL_BINARY=0 bash -s -- officecli\n```\n\n### OpenClaw\n\nIf you want OpenClaw users to generate local Office files directly from Telegram, Discord, Slack, or\nother channels, install the OpenClaw-facing skill package.\n\nUse `wget`:\n\n```bash\nwget -qO- https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-openclaw-skill.sh | bash\n```\n\nOr use `curl`:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-openclaw-skill.sh | bash\n```\n\nThe OpenClaw installer will:\n\n- install `openclaw-officecli` into `~/.openclaw/skills`\n- create `config.yaml` from `config.example.yaml` when needed\n- try to auto-install the `officecli` binary when it is missing\n\nIf you only want the OpenClaw skill and do not want to auto-install the binary:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/officecli/officecli/main/scripts/install-openclaw-skill.sh | AUTO_INSTALL_BINARY=0 bash\n```\n\n## Requirements\n\n- a local `officecli` binary\n- OfficeCLI access through hosted trial, hosted key, or External Mode configuration\n- optional publishing configuration when you want online preview URLs\n- for agent integrations, permission for the agent client to invoke local commands on the same machine\n\nQuick verification after installation:\n\n```bash\nofficecli --version\nofficecli config status\n```\n\nFor OpenClaw, also verify:\n\n```bash\nofficecli agent-bridge\n```\n\n## OfficeCLI and officecli fit together\n\n- `officecli` is the command-line binary you use to generate Office files and images\n- this repository is the public install, docs, demos, and integration surface for that binary\n- `officecli` is also the general optional skill for Claude Code, Codex, and other local agents\n- `openclaw-officecli` is the OpenClaw-oriented package\n\n## FAQ\n\n### Is this repository a hosted SaaS plugin backend?\n\nNo. This repository distributes binary install docs, demos, scripts, and optional local skill wrappers.\n\n### Does the CLI require an AI agent?\n\nNo. The main workflow is direct CLI usage through commands like `officecli new pptx`, `officecli new\ndocx`, `officecli new xlsx`, `officecli new report`, and `officecli new img`.\n\n### Can AI agents create PPTX, DOCX, XLSX, report, or img outputs with this repository?\n\nYes, when the local `officecli` runtime is installed and configured. The repository tells the agent how\nto route supported Office and image tasks into the local OfficeCLI binary.\n\n### Why does this repository mention Codex as well as Claude Code?\n\nBecause marketplace install is only one entrypoint. This repository also distributes direct skill files\nfor Codex-style local agents and other agent runtimes.\n\n### Does this repository contain the full OfficeCLI implementation?\n\nNo. It contains public install docs, demos, scripts, skill definitions, and plugin wrappers.\n\n## Layout\n\n- `install/README.md`: install entrypoint for search and onboarding\n- `claude-code/README.md`: Claude Code marketplace install guide\n- `codex/README.md`: direct local install guide for Codex-style agents\n- `openclaw/README.md`: OpenClaw installer and bridge guide\n- `faq/README.md`: FAQ entrypoint\n- `.claude-plugin/marketplace.json`: Claude Code marketplace definition\n- `demos/`: reproducible demo gallery with preview images, prompts, metadata, and generated files\n- `plugins/officecli/`: Claude Code plugin wrapper for the `officecli` skill\n- `plugins/openclaw-officecli/`: Claude Code plugin wrapper for the `openclaw-officecli` skill\n- `skills/officecli/`: public OfficeCLI skill definition\n- `skills/openclaw-officecli/`: public OpenClaw skill definition\n- `scripts/install-skill.sh`: shell installer for direct `wget` / `curl` usage\n- `scripts/install-openclaw-skill.sh`: shell installer for OpenClaw users\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofficecli%2Fofficecli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fofficecli%2Fofficecli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofficecli%2Fofficecli/lists"}