officedex

The First AI-Native VibeOfficing Platform

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

---

💡 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.

---

📑 Table of Contents

• ⚡ 30-Second Overview
• 🎯 What is OfficeDex
• 💡 VibeOfficing
• 🔥 Why OfficeDex

• ✨ 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

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:

1. OFFICECLI_DESKTOP_BINARY env var
2. officecli on your PATH
3. 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

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.

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.

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

• ✅ 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

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.

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	✅

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.

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

Star History