cli-anything-libreoffice skill by hkuds

cli-anything-libreoffice

A stateful command-line interface for document editing, producing real ODF files (ZIP archives with XML). Designed for AI agents and power users who need to create and manipulate Writer, Calc, and Impress documents without a GUI or LibreOffice installation.

Installation

This CLI is installed as part of the cli-anything-libreoffice package:

pip install cli-anything-libreoffice

Prerequisites:

Python 3.10+
libreoffice must be installed on your system

Usage

Basic Commands

# Show help
cli-anything-libreoffice --help
 
# Start interactive REPL mode
cli-anything-libreoffice
 
# Create a new project

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

Command Groups

Document

Document management commands.

Command	Description
`new`	Create a new document
`open`	Open project JSON, or import an existing Office/ODF file
`import`	Import an existing Office/ODF file to project JSON
`import-formats`	List supported import formats
`save`	Save the current document
`info`	Show document information
`profiles`	List available page profiles
`json`	Print raw project JSON

Writer

Writer (word processor) commands.

Command	Description
`add-paragraph`	Add a paragraph to the document
`add-heading`	Add a heading to the document
`add-list`	Add a list to the document
`add-table`	Add a table to the document
`add-page-break`	Add a page break
`remove`	Remove a content item by index
`list`	List all content items
`set-text`	Set the text of a content item

Calc

Calc (spreadsheet) commands.

Command	Description
`add-sheet`	Add a new sheet
`remove-sheet`	Remove a sheet by index
`rename-sheet`	Rename a sheet
`set-cell`	Set a cell value
`get-cell`	Get a cell value
`list-sheets`	List all sheets

Impress

Impress (presentation) commands.

Command	Description
`add-slide`	Add a slide to the presentation
`remove-slide`	Remove a slide by index
`set-content`	Update a slide's title and/or content
`list-slides`	List all slides
`add-element`	Add an element to a slide

Style Group

Style management commands.

Command	Description
`create`	Create a new style
`modify`	Modify an existing style
`list`	List all styles
`apply`	Apply a style to a content item (Writer only)
`remove`	Remove a style

Export Group

Export/render commands.

Command	Description
`presets`	List export presets
`preset-info`	Show preset details
`render`	Export the document to a file

Session

Session management commands.

Command	Description
`status`	Show session status
`undo`	Undo the last operation
`redo`	Redo the last undone operation
`history`	Show undo history

Examples

Create a New Project

Create a new libreoffice project file.

Interactive REPL Session

Start an interactive session with undo/redo support.

Export Project

Export the project to a final output format.

State Management

The CLI maintains session state with:

Undo/Redo: Up to 50 levels of history
Project persistence: Save/load project state as JSON
Existing file import: Convert ODF/DOCX/XLSX/PPTX and related formats into editable project JSON
Session tracking: Track modifications and changes

Output Formats

All commands support dual output modes:

Human-readable (default): Tables, colors, formatted text
Machine-readable (--json flag): Structured JSON for agent consumption

For AI Agents

When using this CLI programmatically:

Always use --json flag for parseable output
Check return codes - 0 for success, non-zero for errors
Parse stderr for error messages on failure
Use absolute paths for all file operations
Import existing Office files to JSON first with document import input.docx -o work.json
Verify outputs exist after export operations

More Information

Full documentation: See README.md in the package
Test coverage: See TEST.md in the package
Methodology: See HARNESS.md in the cli-anything-plugin

Version

1.0.0