Deckuse CLI
Deckuse is a CLI and skill that edits PPTX and DOCX via JSON commands, with versioned workspaces, validation and undo.
- 105 ★ on the repository
- Last commit
- AGPL-3.0
Minimal access
Why this level
- Edits are written into the workspace and rebuild the document; the original file stays separate.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/deckuseDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Edits are written into the workspace and rebuild the document; the original file stays separate.
This is third-party code. Review the repository files before installing.
What it does
Deckuse opens an Office document into a versioned workspace and lets an agent edit it through semantic addresses such as `slide:1/shape:2`. Every successful write creates a Git revision, appends to `operations.jsonl` and rebuilds the package. PPTX and DOCX adapters are ready, while XLSX, Keynote and Numbers return `FORMAT_NOT_IMPLEMENTED`. The loop is `init` or `new`, then `list` and `get`, edits with `set` and `add`, `validate`, `export`. There are `undo`, `history`, batch `apply`, live preview `monitor` and a PNG slide snapshot via `render`. The skill in `skills/deckuse/SKILL.md` explains units, addresses and common recipes.
Who it is for. Developers and analysts who ask an agent to update existing presentations and Word documents without rebuilding them from scratch.
Good fit when
- Dates, figures and prices are updated in a quarterly deck.
- Variants for different markets are made from one file with reviewable edits.
- Outdated or sensitive text is searched across a document and each match is checked.
- Automated edits must be revertible with `undo`.
Not a fit when
- You need to judge whether a slide looks good: the engine does not judge layout.
- Spreadsheets in XLSX, Keynote or Numbers are edited.
- The document cannot live in a workspace with Git history.
Example request
Open `report.pptx` in a workspace, replace the date on slide two and the total on slide five, validate and export `report-v2.pptx`.Limitations
This is the community edition; the commercial overlay is private. The engine does not fully render slides, so check appearance with `render` and by eye. Node.js 18 or newer is required. The AGPL-3.0 license sets conditions on network use and distributing changes. The skill needs CLI version 1.2.0 or newer. Before sending the modified file, open it in PowerPoint or Word and review it by hand.
How to disable. Remove the package with `npm uninstall -g @deckflow/deckuse` and the skill folder from `.cursor/skills/deckuse/`. Delete document workspaces separately.
FAQ
Which formats are supported?
PPTX and DOCX. The XLSX, Keynote and Numbers adapters return `FORMAT_NOT_IMPLEMENTED`.
How do I revert a bad edit?
Run `deckuse undo --workspace ./workspace --steps 1`. Inspect the log with `history`.
Can I start without an existing file?
Yes. `deckuse new ./workspace` creates a workspace from the bundled blank 16:9 template.
How do I see the result?
`deckuse monitor` opens a live browser preview and `render` saves one slide as PNG.
Is the skill installed separately?
Yes. The CLI installs through npm, and the `skills/deckuse` folder is copied into the agent's skills directory.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI generating PPTX decks, DOCX documents, XLSX workbooks, reports and images from a text prompt in a terminal or script.
A skill plus the docx program: the agent fills forms, edits tables and reviews Word files with tracked changes
A skill that builds editable PowerPoint decks from outline.json with scripts and checks layout and density before delivery.
Skill turns the agent into a deck producer: brief, storyboard, slide posters, QA and a PDF or editable PPTX.
A Rust CLI that probes PDF, Office and iWork files without opening them and returns JSON with page counts and security signals.
A skill that builds presentations from HTML slides with rendering, per-slide visual review, and conversion to an editable PPTX
Comparison with similar tools
Cards that share the main search query, and how they differ.
README in short
The README exists in eight languages, including Russian. The engine preserves untouched XML and unknown package parts where possible.