Clippit.Cli
0.9.0
dotnet tool install --global Clippit.Cli --version 0.9.0
dotnet new tool-manifest
dotnet tool install --local Clippit.Cli --version 0.9.0
#tool dotnet:?package=Clippit.Cli&version=0.9.0
nuke :add-package Clippit.Cli --version 0.9.0
Clippit CLI — dotnet tool
Clippit CLI is a command-line tool for working with OpenXml files (PowerPoint, Word, Excel), built on Clippit — the .NET OpenXml PowerTools library. It supports PPTX split/build/verify workflows, manifest-driven DOCX build/compare/consolidate workflows, DOCX template assembly and markup cleanup, DOCX↔HTML conversion, and XLSX create/verify workflows.
Installation
dotnet tool install -g Clippit.Cli
clippit --version
To update an existing global tool installation:
dotnet tool update -g Clippit.Cli
Workspace skills
Install local workspace skills for compatible coding assistants:
clippit install --skills # .agents/skills/clippit
clippit install --skills=claude # .claude/skills/clippit
clippit install --skills=all # both targets
The default writes the shared .agents project-local skill location used by OpenCode and Pi. Use --skills=claude for Claude Code or --skills=all for workspaces that use multiple assistants. Re-running the command replaces installed skills with the current bundled versions. Use --dry-run to preview target paths.
clippit install --skills=all --dry-run
Quick Start
# Split a deck into individual slides
clippit pptx split presentation.pptx --output ./slides/
# Build a deck from a manifest
clippit pptx build run manifest.json --output result.pptx
# Validate a PPTX file
clippit pptx verify presentation.pptx
# Validate a DOCX file
clippit word verify document.docx
# Scaffold a Word build manifest and merge it into a DOCX
clippit word build init --output word-build.json
clippit word build run word-build.json --output merged.docx
# Compare two DOCX files with tracked revisions
clippit word compare before.docx after.docx --output compared.docx
# Consolidate multiple DOCX revisions into one tracked-changes file
clippit word consolidate original.docx alice.docx bob.docx --output consolidated.docx
# Assemble a DOCX template with XML data
clippit word assemble template.docx data.xml --output assembled.docx
# Accept all tracked revisions in a DOCX file
clippit word accept-revisions draft.docx
# Remove non-content markup from a DOCX file
clippit word simplify-markup document.docx --accept-revisions --remove-comments
# Convert DOCX to HTML
clippit word to-html document.docx
# Convert HTML to DOCX
clippit word from-html article.html --css styles.css
# Validate an XLSX file
clippit excel verify spreadsheet.xlsx
# Create an XLSX workbook from a JSON definition
clippit excel create workbook.json --output report.xlsx
# Get JSON output for scripting
clippit pptx split presentation.pptx --format json
Commands
| Command | Description |
|---|---|
pptx split |
Split a .pptx into individual single-slide files. Supports slide range selection (--slides) and manifest generation (--manifest). |
pptx build init |
Scaffold a deck manifest (JSON). |
pptx build run |
Assemble a .pptx from a deck manifest. |
pptx verify |
Validate a PPTX — schema, relationships, markup compatibility, and sections. |
word build init |
Scaffold a Word build manifest (JSON). |
word build run |
Assemble a .docx from a Word build manifest. |
word assemble |
Assemble a DOCX template with XML data. |
word compare |
Compare two DOCX files and produce a tracked-revision DOCX. |
word consolidate |
Combine multiple DOCX revisions into one tracked-changes DOCX. |
word accept-revisions |
Accept all tracked revisions in a DOCX file. |
word simplify-markup |
Remove non-content markup from a DOCX file. |
word verify |
Validate a DOCX — schema and relationships. |
word to-html |
Convert a DOCX to HTML/CSS. |
word from-html |
Convert HTML/CSS to a DOCX. |
excel to-html |
Convert an XLSX sheet, range, or table to HTML/CSS. |
excel create |
Generate an .xlsx workbook from a JSON workbook definition. |
excel verify |
Validate an XLSX — schema and relationships. |
install --skills |
Install Clippit workspace skills into the current workspace. |
version |
Print version information. |
Common flags
| Flag | Description |
|---|---|
--format json|text |
Structured JSON or human-readable output (default: text) |
--quiet / -q |
Suppress success output; exit codes still reflect result |
--force |
Overwrite existing output files |
- |
Use stdin / stdout for piped workflows |
Machine-readable output
Success payloads → stdout (compact JSON when --format json or stdout is piped).
Command errors → stderr (compact JSON with a stable symbolic code).
Published JSON schemas for manifests and result payloads are available at
docs/schemas/.
Full documentation
➡️ https://sergey-tihon.github.io/Clippit/cli.html
License
MIT © Sergey Tihon
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.