iOfficeAI/OfficeCLI

Kết luận: fit · Công nghệ: office-cli · docx · xlsx · pptx · ai-agent-tools

OfficeCLI là một CLI/tool mã nguồn mở để đọc, sửa và tự động hóa tệp docx, xlsx, pptx cho AI agent, không cần cài Microsoft Office. Với ~15.9k sao và định vị rõ cho workflow agent/Codex/Claude Code, đây là lựa chọn đáng thử khi cần xử lý tài liệu Office trong pipeline tự động hoặc công cụ nội bộ.

📖 Giới thiệu chi tiết

🧩 Nó là gì?

iOfficeAI/OfficeCLI là một công cụ dòng lệnh (CLI — chạy bằng lệnh trong terminal) giúp AI agent hoặc lập trình viên đọc, tạo, chỉnh sửa và tự động hóa file Word, Excel, PowerPoint: .docx, .xlsx, .pptx.

Điểm hay là bạn không cần cài Microsoft Office, không cần thư viện phụ phức tạp, chỉ dùng một binary duy nhất tên officecli.

🎯 Giải quyết vấn đề gì? Dành cho ai?

OfficeCLI giải quyết một vấn đề rất thực tế: làm sao để AI hoặc script có thể thao tác với tài liệu Office một cách đáng tin cậy.

Thay vì phải mở Word/Excel/PowerPoint bằng tay, hoặc viết nhiều dòng code với nhiều thư viện khác nhau, bạn có thể dùng các lệnh như:

officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report"
officecli view deck.pptx html

Dự án này phù hợp cho:

• Người dùng AI coding agent như Claude Code, Cursor, Windsurf, GitHub Copilot, Codex.
• Lập trình viên muốn tự động tạo báo cáo, bảng tính, slide thuyết trình.
• Team nội bộ cần xử lý hàng loạt file Office trong pipeline tự động.
• Người muốn cho AI “nhìn” và sửa tài liệu Office mà không cần mở Microsoft Office.
• Người mới muốn có cách đơn giản để tạo/chỉnh file .docx, .xlsx, .pptx bằng lệnh.

Nói ngắn gọn: nếu bạn muốn AI hoặc chương trình của mình đọc, hiểu, sửa và tạo tài liệu Office, OfficeCLI là công cụ rất đáng thử.

⚙️ Hoạt động ra sao?

Cơ chế chính của OfficeCLI khá dễ hiểu:

• Bạn cài một lệnh duy nhất là officecli.
• Bạn đưa vào file Office như .docx, .xlsx, .pptx.
• Bạn dùng các lệnh như create, add, set, remove, view, get, close để thao tác với tài liệu.
• OfficeCLI có thể đọc cấu trúc tài liệu và trả về dạng dễ hiểu như text, outline hoặc JSON.
• AI agent có thể dùng kết quả đó để biết trong tài liệu đang có gì, rồi tiếp tục chỉnh sửa.
• Công cụ có engine render HTML/PNG tích hợp, tức là có thể biến tài liệu thành bản xem trước trong trình duyệt.
• Nhờ cơ chế render này, AI có thể đi theo vòng lặp: tạo/sửa → xem kết quả → sửa tiếp.
• Không cần cài Microsoft Office trên máy.
• Không cần cài thêm nhiều thư viện phụ.
• Có thể dùng cho cả Word, Excel và PowerPoint.

Ví dụ, với PowerPoint, bạn có thể tạo file, thêm slide, thêm text box, rồi xem trước ngay trong trình duyệt:

officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report"
officecli view deck.pptx html

🆚 Khi nào nên dùng / không nên

Nên dùng OfficeCLI khi:

• Bạn muốn AI agent thao tác trực tiếp với file Office.
• Bạn cần tạo hoặc sửa .docx, .xlsx, .pptx trong script tự động.
• Bạn không muốn phụ thuộc vào Microsoft Office.
• Bạn muốn có một công cụ chung cho Word, Excel và PowerPoint.
• Bạn muốn xem trước tài liệu bằng HTML hoặc PNG.
• Bạn đang làm báo cáo, dashboard, proposal, slide thuyết trình tự động.

So với cách viết code Python bằng nhiều thư viện, OfficeCLI thường ngắn gọn hơn. Ví dụ thay vì viết nhiều dòng để tạo slide, bạn có thể dùng:

officecli add deck.pptx / --type slide --prop title="Q4 Report"

Không nên dùng OfficeCLI khi:

• Bạn chỉ cần chỉnh sửa thủ công vài dòng trong Word/Excel/PowerPoint bằng giao diện quen thuộc.
• Bạn cần những thao tác rất đặc thù chỉ có trong Microsoft Office desktop.
• Bạn không quen dùng terminal và cũng không có AI agent hỗ trợ.
• Bạn cần đảm bảo 100% mọi chi tiết hiển thị giống hệt Microsoft Office trong mọi trường hợp phức tạp.

Nếu bạn thích giao diện đồ họa hơn terminal, README gợi ý dùng AionUi, một app desktop dùng OfficeCLI ở bên dưới để tạo và sửa tài liệu bằng ngôn ngữ tự nhiên.

🚀 Bắt đầu nhanh

Nếu bạn dùng AI agent, cách nhanh nhất là đưa dòng này cho agent:

curl -fsSL https://officecli.ai/SKILL.md

Skill file này sẽ hướng dẫn agent cách cài OfficeCLI và dùng các lệnh cần thiết.

Nếu bạn là lập trình viên hoặc muốn tự cài bằng terminal:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex

Hoặc có thể cài bằng:

brew install officecli
npm install -g @officecli/officecli

Ví dụ tối thiểu để tạo một file PowerPoint:

# Tạo file PowerPoint mới
officecli create deck.pptx

# Thêm một slide
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E

# Thêm một hộp chữ vào slide đầu tiên
officecli add deck.pptx '/slide[1]' --type shape \
  --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
  --prop font=Arial --prop size=24 --prop color=FFFFFF

# Xem cấu trúc tài liệu
officecli view deck.pptx outline

# Xem bản render HTML trong trình duyệt
officecli view deck.pptx html

# Lấy dữ liệu JSON của một phần tử
officecli get deck.pptx '/slide[1]/shape[1]' --json

# Lưu và đóng phiên làm việc
officecli close deck.pptx

Nếu muốn xem trước trực tiếp trong trình duyệt khi đang chỉnh sửa:

# Tạo PowerPoint trống
officecli create deck.pptx

# Mở live preview tại http://localhost:26315
officecli watch deck.pptx

# Mở terminal khác rồi thêm slide
officecli add deck.pptx / --type slide --prop title="Hello, World!"

Mỗi lần bạn chạy add, set hoặc remove, bản xem trước sẽ được cập nhật gần như ngay lập tức.

✅ Điểm mạnh & ⚠️ Hạn chế

Điểm mạnh:

• Mã nguồn mở, miễn phí, license Apache 2.0.
• Một binary duy nhất, dễ cài và dễ mang đi.
• Không cần cài Microsoft Office.
• Hỗ trợ cả Word .docx, Excel .xlsx, PowerPoint .pptx.
• Có thể đọc, tạo và chỉnh sửa tài liệu.
• Phù hợp mạnh với AI agent như Claude Code, Cursor, Windsurf, GitHub Copilot, Codex.
• Có thể render tài liệu sang HTML hoặc PNG để xem trước.
• Có thể xuất thông tin dạng JSON, rất tiện cho tự động hóa.
• Lệnh ngắn gọn, dễ ghép vào script hoặc pipeline.
• Có live preview qua officecli watch.

Hạn chế:

• Vẫn cần dùng terminal hoặc AI agent để khai thác tốt nhất.
• Với người chỉ quen bấm chuột trong Office, ban đầu có thể hơi lạ.
• Một số tài liệu Office quá phức tạp có thể không render/chỉnh sửa hoàn hảo như Microsoft Office desktop.
• Không phải lựa chọn tối ưu nếu bạn chỉ cần sửa thủ công một file đơn giản.
• Cần học cách chỉ định vị trí phần tử như /slide[1]/shape[1] khi muốn chỉnh sửa chính xác.