officecli/officedex: OfficeDex is the first Al-Native VibeOfficing platform for documents, slides, and spreadsheets

The First AI-Native VibeOfficing Platform

VibeCoding writes code. VibeOfficing writes documents. Powered by OfficeDex.

Version

💡 VibeOfficing

Developers already VibeCode — describe intent, AI writes the program. VibeOfficing is the same paradigm for documents.

Say what you need → OfficeDex produces native .docx / .pptx / .xlsx directly.

Understands OOXML formats, templates, and layout conventions — the same way coding AI understands languages, frameworks, and design patterns
No intermediate HTML. No copy-paste. No manual formatting.
The output is the final file.

!VibeCoding = VibeOfficing

| Coding World | Office World | What AI Learns | | ------------------------------------ | ---------------------------------------------------------------- | --------------------- | | Languages (Python / Go / TS) | Formats (OOXML: .docx / .pptx / .xlsx) | Syntax | | Frameworks (React / Django / Spring) | Templates (quarterly reports, pitch decks, competitive analysis) | Structure | | Design patterns (MVC / Observer) | Layout habits (heading hierarchy, color schemes, chart styles) | Style conventions |

Memory · Format · Agent

OfficeDex is not just "one prompt → one file." It's a document workspace with memory.

Memory — Remembers your style and design language across sessions. Your 50th report inherits the same polish as your 1st.
Format — Handles OOXML natively. No HTML rendering, no export-and-pray.
Agent — Multiple AI agents collaborate: one plans structure, one writes content, one handles formatting.

OfficeDex remembers how your documents look — not just what they say. Digitize your style into OfficeDex — never start from scratch again.

!OfficeDex Engine

⚡ OfficeDex in 30 Seconds

Input

"Write a Q3 sales analysis report focused on the eastern region, include YoY and QoQ charts, target audience is the CFO."

Output

📄 Q3-East-Sales.docx (12 pages) 📊 4 data charts + 3 trend analyses ⏱ Typical generation: 45–90s 👁 One-click inline preview — no need to open Word

!30-second demo

_{↑ From one sentence to a finished Word doc in under a minute.}

✨ Core Capabilities
🚀 Quick Start
📦 Build & Release

🧩 Architecture
🎨 Design Language
🗺 Roadmap

❓ FAQ
📚 Documentation
🤝 Feedback & Contributing

🎯 What is OfficeDex

In one sentence: Tell it what you want — it generates Word / PPT / Excel for you.

📝 Natural language to documents — Type "write a Q3 sales analysis report" and get structure, sections, illustrations, and charts automatically
🎨 Slides in one shot — Project kickoffs, product launches, industry briefings: built-in templates plus custom prompts
📊 Spreadsheets & analysis — Competitive matrices, financial models, survey results — Excel ready out of the box
🖼️ Image input supported — Paste screenshots or upload reference images; the AI understands visual context
⚙️ Run locally or hosted — Bring your own LLM (OpenAI / Claude / self-hosted) or use the OfficeCLI hosted runtime

!Feature matrix

🔥 Why OfficeDex

| Dimension | Web AI assistants | CLI tools | OfficeDex | | ----------------------- | :----------------: | :------------: | :--------------------------------------------: | | 🖥 Native desktop feel | In-browser | Terminal | ✅ Wails native window | | 📂 Local-first files | Manual download | ✅ Direct save | ✅ Direct save + one-click open | | 👀 Inline preview | Open Office needed | None | ✅ DOCX/PPTX/XLSX rendered inline | | 🔌 Custom LLM | Vendor-locked | ✅ Any | ✅ Any + GUI config | | 🎨 UI & interaction | Generic | Plain text | ✅ Purpose-built interaction prototype | | 🔒 Data sovereignty | Cloud-first | ✅ Local | ✅ Local (hosted optional) | | 💬 Mid-task interaction | Single-turn chat | None | ✅ AI asks back in real time, streaming status |

In a phrase: Stop formatting. Start VibeOfficing.

✨ Core Capabilities

1. Conversational generation — write docs like chatting

Built-in scenarios (quarterly reports / kickoff slides / competitive analysis)
Free-form prompts: control length, tone, target audience
Continuous context: keep asking — "now add a page on risk assessment"

2. Live task stream — watch every step

Streaming events → see what the AI is thinking and doing
Mid-flight interaction: when the AI is unsure, it asks you to decide
Cancel any time, restart any time

3. Inline preview — no need to open Office


_{Word document}	_Spreadsheet

Powered by docx-preview / pdfjs-dist / xlsx for inline rendering. DOCX / PPTX / XLSX / PDF all preview-able — no Office install required.

4. Configurable from Settings — no CLI required

!Settings page

Custom LLM: OpenAI / Anthropic / Azure / self-hosted vLLM
Custom OfficeCLI binary path (for developers)
One-click runtime check & upgrade; works offline with a local binary

🚀 Quick Start

Users: download the installer

| Platform | Installer | Notes | | -------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------- | | 🍎 macOS (Apple Silicon / Intel) | OfficeDex-x.y.z-arm64.dmg / -x64.dmg | Double-click .dmg → drag to Applications | | 🪟 Windows 10/11 | OfficeDex-Setup-x.y.z.exe | Double-click to install. First launch auto-downloads the OfficeCLI runtime. |

Latest Release: github.com/officecli/officedex/releases/latest

[!IMPORTANT]

> ### 🍎 macOS users — "OfficeDex.app" cannot be opened?

> Because the app is not yet Apple-notarized, Gatekeeper will block the first launch with a "Apple could not verify..." dialog.

> Fix: run the following command once in Terminal to strip the quarantine attribute, then you can double-click to open as usual:

> xattr -dr com.apple.quarantine /Applications/OfficeDex.app

> If the app lives elsewhere (e.g. ~/Downloads/OfficeDex.app), substitute the actual path. This is a one-time operation and won't recur.

Developers: run from source

# 1. Clone & install
git clone <your-repo-url>
cd officedex
npm install
2. Start the desktop app or browser renderer
npm run dev
3. Type-check / unit tests / E2E
npm run lint
npx vitest run
npm run test:e2e

To test the renderer in a local browser while using the real Go/OfficeCLI bridge, run npm run dev:browser in one terminal and use the browser URL shown by Vite. The real E2E runner starts and cleans up its own bridge host and Vite processes with npm run test:e2e.

In dev mode, OfficeDex resolves the CLI in this order:

OFFICECLI_DESKTOP_BINARY env var
officecli on your PATH
Auto-download from GitHub Releases (default source: officecli/officecli)

📦 Build & Release

npm run dist:mac      # macOS (auto-codesigns bundled officecli)
npm run dist:win      # Windows

Build artifacts land in build/bin/. CI (.github/workflows/release.yml) produces .dmg / .zip / .exe and publishes a GitHub Release on every v* tag.

🧩 Architecture

┌───────────────────────────────────────────────────┐
│  OfficeDex (this repo)                            │
│  ┌──────────────────┐    ┌────────────────────┐   │
│  │  React 19 + Antd │ ←→ │  Wails Go runtime  │   │
│  │  Notion-styled   │    │  (main.go/app.go)  │   │
│  └──────────────────┘    └─────────┬──────────┘   │
└─────────────────────────────────────┼─────────────┘
                                      │ JSON-RPC stdio
                                      ▼
                          ┌────────────────────────┐
                          │  officecli agent-bridge│
                          │  (Go binary, sep. repo)│
                          └────────────────────────┘

Frontend: React 19 + Ant Design 6 + the shell's own tokens (src/shell/tokens.css)
Desktop shell: Wails v2 (Go backend + system WebView frontend) — compact bundle size (build output < 30MB)
Generation engine: decoupled officecli subprocess, communicating via JSON-RPC
Preview: docx-preview / pdfjs-dist / xlsx inline rendering — no Office install required

🎨 Design Language

The single source of truth is the approved interaction prototype, OfficeDex-Final-Light-Preview-2026-09-17.html. Its tokens are projected into src/shell/tokens.css — read that file before any UI work.

Ink #41464b · Chrome #f5f6f8 · Accent #596f86
Typography platform UI stack, "PingFang SC" first; 12px body
Shape radii from --shell-radius-* (5 / 6 / 10 / 14 / 20px); no pills
Motion cubic-bezier(.22, 1, .36, 1)

🛠 OfficeCLI Runtime Management

On first launch, OfficeDex pulls the matching officecli binary from GitHub Releases:

Default source: officecli/officecli (override via OFFICECLI_RELEASE_REPO)
Cache directory: ~/Library/Application Support/OfficeDex/runtime/ (macOS)
Asset naming: officecli-{darwin|win32|linux}-{arm64|x64}{.exe}

From Settings → OfficeCLI Runtime you can: check for updates / switch versions / specify a local binary / revert to auto-downloaded.

🗺 Roadmap

What's on the way (in priority order):

| Status | Capability | Notes | | :------------: | ---------------------------------- | ----------------------------------- | | ✅ Shipped | Document / PPT / Excel generation | Three core formats | | ✅ Shipped | Inline preview panel | DOCX / PPTX / XLSX / PDF | | ✅ Shipped | Image input (visual understanding) | Paste or upload reference images | | ✅ Shipped | Notion-style UI | Customizable design tokens | | 🚧 In progress | Multilingual UI (EN / 日本語) | Translation in preparation | | 🚧 In progress | Template marketplace | Community-shared prompts and styles | | 🔜 Planned | Collaborative mode | Multi-user editing on the same task | | 🔜 Planned | Plugin system | Third-party generators | | 🔜 Planned | Official Linux installers | AppImage / deb | | 💭 Exploring | Mobile companion app | iOS / Android: view and trigger |

❓ FAQ

How does OfficeDex relate to OfficeCLI?

OfficeCLI is the underlying command-line tool (a separate Go repo) that handles actual document generation, LLM calls, and file output. OfficeDex is its desktop GUI shell: a React UI wrapped in Wails, talking to the officecli agent-bridge subprocess via JSON-RPC. They release in lockstep: OfficeDex auto-downloads and manages a matching OfficeCLI binary at startup.

Is my data uploaded to the cloud?

By default, fully local:

Document generation runs on your machine
LLM calls go directly to the provider you configured (OpenAI / Anthropic / self-hosted) — OfficeDex never proxies them
Generated files and document context live in a local workspace (default: ~/Library/Application Support/OfficeDex/workspace; optionally choose another folder in Settings)

If you opt into "Hosted Runtime" (Hosted Runtime = OfficeCLI's official hosted proxy, so you don't have to configure your own LLM key), some calls route through the official proxy — the app displays a clear notice in that case.

Can I use my own OpenAI / Claude API key?

Yes. In Settings → LLM Provider, fill in baseUrl / apiKey / model. Supported:

OpenAI official + compatible protocols (DeepSeek / Moonshot / self-hosted vLLM, etc.)
Anthropic Claude
Azure OpenAI

Which operating systems are supported?

✅ macOS 12+ (Apple Silicon and Intel)
✅ Windows 10 / 11 (x64)
🚧 Linux — binaries are built, but no official installer yet; run from source via npm run dev

Where are generated files stored?

Default workspace:

macOS: ~/Library/Application Support/OfficeDex/workspace
Windows: %APPDATA%/OfficeDex/workspace

Leave the workspace setting empty to use the default app-data workspace, or choose another folder via Settings → Workspace. After each generation, click "Show in Folder" to jump straight there.

Which document formats are supported?

| Input | Output | Preview | | -------------------------------------------------- | ------------------------------------ | ------------------------- | | Natural-language prompt | .docx / .pptx / .xlsx / .pdf | ✅ All inline-previewable | | Upload .docx / .pdf / .md as source material | Same | ✅ | | Paste / upload images as reference | Same | ✅ |

Can I use it offline?

The desktop shell and preview panel are fully offline. Document generation needs an LLM, so:

Cloud APIs: requires internet
Local models (Ollama / vLLM / LM Studio): fully offline — point baseUrl at e.g. http://localhost:11434/v1

The OfficeCLI runtime also supports a manually specified local path — no downloads required.

How do I report a bug?

In the app, click "Report Issue" in the top-right corner. It automatically collects:

App version + platform info
Recent OfficeCLI logs (sanitized)
Current task state snapshot

Copy the generated markdown and paste it into a GitHub Issue.

📚 Documentation

src/shell/tokens.css — Design tokens, projected from the approved interaction prototype
CLAUDE.md — Project conventions & collaboration guidelines
docs/README.zh-CN.md — 简体中文版
docs/aippt-jssdk-design-method.md — AI PPT JSSDK design, free composition, and layout acceptance method
docs/aippt-jssdk-visual-gap-report.md — Visual gap analysis against Cheso examples and next-step roadmap
docs/aippt-chart-authoring-plan.md — Chart authoring API, OfficeDex data contract, and regression plan

🤝 Feedback & Contributing

🐛 Bugs / suggestions: click "Report Issue" in-app — diagnostics are bundled automatically
💬 Discussion: PRs and issues welcome
⭐ Like it? A star is the best encouragement for the team

_{Made with 💜 by the OfficeDex team · Runs natively on macOS / Windows}