> ## Documentation Index
> Fetch the complete documentation index at: https://superdoc-nick-sd-2070-add-content-controls-namespace-to-doc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# SDKs
> Node.js and Python SDKs for programmatic document editing
SuperDoc SDKs let you open, read, and edit `.docx` files from Node.js or Python. They manage the CLI process for you and expose typed methods for every operation.
The SDKs are in alpha. The API surface matches the [Document API](/document-api/overview) and will evolve alongside it.
## Installation
```bash theme={null}
npm install @superdoc-dev/sdk
```
```bash theme={null}
pip install superdoc-sdk
```
The CLI is bundled with the SDK — no separate install needed.
## Quick start
The Node SDK supports both ESM and CommonJS:
```ts theme={null}
// ESM
import { createSuperDocClient } from '@superdoc-dev/sdk';
// CommonJS
const { createSuperDocClient } = require('@superdoc-dev/sdk');
```
```typescript theme={null}
import { SuperDocClient } from '@superdoc-dev/sdk';
const client = new SuperDocClient({
defaultChangeMode: 'tracked',
});
// Open a document
await client.doc.open({ doc: './contract.docx' });
// Find and replace text with query + mutation plan
const match = await client.doc.query.match({
select: { type: 'text', pattern: 'ACME Corp' },
require: 'first',
});
const ref = match.items?.[0]?.handle?.ref;
if (ref) {
await client.doc.mutations.apply({
expectedRevision: match.evaluatedRevision,
atomic: true,
steps: [
{
id: 'replace-acme',
op: 'text.rewrite',
where: { by: 'ref', ref },
args: { replacement: { text: 'NewCo Inc.' } },
},
],
});
}
// Save and close
await client.doc.save();
await client.doc.close();
```
```javascript theme={null}
const { SuperDocClient } = require('@superdoc-dev/sdk');
async function main() {
const client = new SuperDocClient({
defaultChangeMode: 'tracked',
});
// Open a document
await client.doc.open({ doc: './contract.docx' });
// Find and replace text with query + mutation plan
const match = await client.doc.query.match({
select: { type: 'text', pattern: 'ACME Corp' },
require: 'first',
});
const ref = match.items?.[0]?.handle?.ref;
if (ref) {
await client.doc.mutations.apply({
expectedRevision: match.evaluatedRevision,
atomic: true,
steps: [
{
id: 'replace-acme',
op: 'text.rewrite',
where: { by: 'ref', ref },
args: { replacement: { text: 'NewCo Inc.' } },
},
],
});
}
// Save and close
await client.doc.save();
await client.doc.close();
}
main();
```
```python theme={null}
import asyncio
from superdoc import AsyncSuperDocClient
async def main():
async with AsyncSuperDocClient(default_change_mode="tracked") as client:
# Open a document
await client.doc.open({"doc": "./contract.docx"})
# Find and replace text with query + mutation plan
match = await client.doc.query.match(
{
"select": {"type": "text", "pattern": "ACME Corp"},
"require": "first",
}
)
items = match.get("items") or []
first_item = items[0] if items else {}
ref = first_item.get("handle", {}).get("ref")
if ref:
await client.doc.mutations.apply(
{
"expectedRevision": match["evaluatedRevision"],
"atomic": True,
"steps": [
{
"id": "replace-acme",
"op": "text.rewrite",
"where": {"by": "ref", "ref": ref},
"args": {"replacement": {"text": "NewCo Inc."}},
}
],
}
)
# Save and close
await client.doc.save({"inPlace": True})
await client.doc.close({})
asyncio.run(main())
```
Set `defaultChangeMode: 'tracked'` (Node) or `default_change_mode='tracked'` (Python) to make mutations use tracked changes by default. If you pass `changeMode` on a specific call, that explicit value overrides the default.
The Python SDK also exposes synchronous `SuperDocClient` with the same `doc.*` operations when you prefer non-async code paths.
## User identity
By default the SDK attributes edits to a generic "CLI" user. Set `user` on the client to identify your automation in comments, tracked changes, and collaboration presence:
```typescript theme={null}
const client = new SuperDocClient({
user: { name: 'Review Bot', email: 'bot@example.com' },
});
```
```python theme={null}
client = AsyncSuperDocClient(user={"name": "Review Bot", "email": "bot@example.com"})
```
The `user` is injected into every `doc.open` call. If you pass `userName` or `userEmail` on a specific `doc.open`, those per-call values take precedence.
## Collaboration sessions
Use this when your app already has a live collaboration room (Liveblocks, Hocuspocus, or SuperDoc Yjs).
### Join an existing room
Pass `collabUrl` and `collabDocumentId` to `doc.open`:
```typescript theme={null}
import { SuperDocClient } from '@superdoc-dev/sdk';
const client = new SuperDocClient();
await client.connect();
await client.doc.open({
collabUrl: 'ws://localhost:4000',
collabDocumentId: 'my-doc-room',
});
await client.doc.insert({
target: { type: 'end' },
content: 'Added by the SDK',
});
```
```python theme={null}
import asyncio
from superdoc import AsyncSuperDocClient
async def main():
async with AsyncSuperDocClient() as client:
await client.doc.open({
"collabUrl": "ws://localhost:4000",
"collabDocumentId": "my-doc-room",
})
await client.doc.insert({
"target": {"type": "end"},
"content": "Added by the SDK",
})
asyncio.run(main())
```
### Start an empty room from a local `.docx`
If the room is empty, pass `doc` together with collaboration params:
```typescript theme={null}
await client.doc.open({
doc: './starting-template.docx',
collabUrl: 'ws://localhost:4000',
collabDocumentId: 'my-doc-room',
});
```
```python theme={null}
await client.doc.open({
"doc": "./starting-template.docx",
"collabUrl": "ws://localhost:4000",
"collabDocumentId": "my-doc-room",
})
```
What happens when you pass `doc`:
| Room state | Result |
| -------------------------------------- | ------------------------------------------ |
| Room already has content | SDK joins the room. `doc` is ignored. |
| Room is empty and `doc` is provided | SDK seeds the room from `doc`, then joins. |
| Room is empty and no `doc` is provided | SDK starts a blank document. |
### Control empty-room behavior
| Parameter | Type | Default | Description |
| --------------------- | -------- | ------------- | ------------------------------------------------------- |
| `collabUrl` | `string` | — | WebSocket URL for your collaboration provider. |
| `collabDocumentId` | `string` | session ID | Room/document ID on the provider. |
| `doc` | `string` | — | Local `.docx` used only when the room is empty. |
| `onMissing` | `string` | `seedFromDoc` | `seedFromDoc`, `blank`, or `error`. |
| `bootstrapSettlingMs` | `number` | `1500` | Wait time (ms) before seeding to avoid race conditions. |
The three `onMissing` values:
| Value | When the room is empty | Use when |
| ----------------------- | --------------------------------------------------------------- | ---------------------------------------------------------- |
| `seedFromDoc` (default) | Seeds from `doc` if provided, otherwise seeds a blank document. | First-time opens where you provide a `.docx` template. |
| `blank` | Always seeds a blank document. | You want an empty starting document regardless of `doc`. |
| `error` | Throws an error instead of seeding. | Reopening existing ydocs — prevents accidental overwrites. |
If you reopen an existing ydoc without providing a `doc` file, the default `seedFromDoc` will seed a blank document if the room appears empty during sync. This **overwrites your existing content**. Always use `onMissing: 'error'` when reopening documents that were previously created or populated.
```typescript theme={null}
// Safe reopen — throws if the room is unexpectedly empty
await client.doc.open({
collabUrl: 'ws://localhost:4000',
collabDocumentId: 'my-doc-room',
onMissing: 'error',
});
```
```python theme={null}
# Safe reopen — throws if the room is unexpectedly empty
await client.doc.open({
"collabUrl": "ws://localhost:4000",
"collabDocumentId": "my-doc-room",
"onMissing": "error",
})
```
### Check if the SDK seeded or joined
`doc.open` returns bootstrap details in collaboration mode:
```typescript theme={null}
const result = await client.doc.open({
doc: './starting-template.docx',
collabUrl: 'ws://localhost:4000',
collabDocumentId: 'my-doc-room',
});
console.log(result.bootstrap);
// { roomState, bootstrapApplied, bootstrapSource }
```
```python theme={null}
result = await client.doc.open({
"doc": "./starting-template.docx",
"collabUrl": "ws://localhost:4000",
"collabDocumentId": "my-doc-room",
})
print(result.get("bootstrap"))
```
## Available operations
The SDKs expose all operations from the [Document API](/document-api/overview) plus lifecycle and session commands. The tables below are grouped by category.
#### Core
| Operation | CLI command | Description |
| ----------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `doc.get` | `get` | Read the full document as an SDDocument structure. |
| `doc.find` | `find` | Search the document for text or node matches using SDM/1 selectors. |
| `doc.getNode` | `get-node` | Retrieve a single node by target position. |
| `doc.getNodeById` | `get-node-by-id` | Retrieve a single node by its unique ID. |
| `doc.getText` | `get-text` | Extract the plain-text content of the document. |
| `doc.getMarkdown` | `get-markdown` | Extract the document content as a Markdown string. |
| `doc.getHtml` | `get-html` | Extract the document content as an HTML string. |
| `doc.markdownToFragment` | `markdown-to-fragment` | Convert a Markdown string into an SDM/1 structural fragment. |
| `doc.info` | `info` | Return document metadata including revision, node count, and capabilities. |
| `doc.clearContent` | `clear-content` | Clear all document body content, leaving a single empty paragraph. |
| `doc.insert` | `insert` | Insert content at a target position, or at the end of the document when target is omitted. Accepts two input shapes: legacy string-based (value + type) or structural SDFragment (content). Supports text (default), markdown, and html content types via the `type` field in legacy mode. Structural mode accepts an SDFragment with typed nodes (paragraphs, tables, images, etc.). |
| `doc.replace` | `replace` | Replace content at a target position with new content. Accepts two input shapes: legacy string-based (text) or structural SDFragment (content). Structural mode replaces the target range with typed nodes (paragraphs, tables, images, etc.). |
| `doc.delete` | `delete` | Delete content at a target position. |
| `doc.blocks.delete` | `blocks delete` | Delete an entire block node (paragraph, heading, list item, table, image, or sdt) deterministically. |
| `doc.query.match` | `query match` | Deterministic selector-based search with cardinality contracts for mutation targeting. |
| `doc.mutations.preview` | `mutations preview` | Dry-run a mutation plan, returning resolved targets without applying changes. |
| `doc.mutations.apply` | `mutations apply` | Execute a mutation plan atomically against the document. |
| `doc.capabilities.get` | `capabilities` | Query runtime capabilities supported by the current document engine. |
| `doc.hyperlinks.list` | `hyperlinks list` | List all hyperlinks in the document, with optional filtering by href, anchor, or display text. |
| `doc.hyperlinks.get` | `hyperlinks get` | Retrieve details of a specific hyperlink by its inline address. |
| `doc.hyperlinks.wrap` | `hyperlinks wrap` | Wrap an existing text range with a hyperlink. |
| `doc.hyperlinks.insert` | `hyperlinks insert` | Insert new linked text at a target position. |
| `doc.hyperlinks.patch` | `hyperlinks patch` | Update hyperlink metadata (destination, tooltip, target, rel) without changing display text. |
| `doc.hyperlinks.remove` | `hyperlinks remove` | Remove a hyperlink. Mode 'unwrap' preserves display text; 'deleteText' removes the linked content entirely. |
| `doc.create.contentControl` | `create content-control` | Create a new content control (SDT) in the document. |
| `doc.contentControls.list` | `content-controls list` | List all content controls in the document with optional type/tag filtering. |
| `doc.contentControls.get` | `content-controls get` | Retrieve a single content control by target. |
| `doc.contentControls.listInRange` | `content-controls list-in-range` | List content controls within a block range. |
| `doc.contentControls.selectByTag` | `content-controls select-by-tag` | Select content controls matching a specific tag value. |
| `doc.contentControls.selectByTitle` | `content-controls select-by-title` | Select content controls matching a specific title (alias) value. |
| `doc.contentControls.listChildren` | `content-controls list-children` | List direct child content controls nested inside the target. |
| `doc.contentControls.getParent` | `content-controls get-parent` | Get the parent content control of the target, if any. |
| `doc.contentControls.wrap` | `content-controls wrap` | Wrap existing content with a new content control. |
| `doc.contentControls.unwrap` | `content-controls unwrap` | Remove the content control wrapper, preserving its content in place. |
| `doc.contentControls.delete` | `content-controls delete` | Delete a content control and its content from the document. |
| `doc.contentControls.copy` | `content-controls copy` | Copy a content control to a destination position. Copied SDTs receive new IDs. |
| `doc.contentControls.move` | `content-controls move` | Move a content control to a new position. Preserves original IDs. |
| `doc.contentControls.patch` | `content-controls patch` | Patch metadata properties on a content control (tag, alias, appearance, color, etc.). |
| `doc.contentControls.setLockMode` | `content-controls set-lock-mode` | Set the lock mode on a content control. |
| `doc.contentControls.setType` | `content-controls set-type` | Transition a content control to a different semantic type. Metadata-only; no implicit content rewrite. |
| `doc.contentControls.getContent` | `content-controls get-content` | Get the text content of a content control. |
| `doc.contentControls.replaceContent` | `content-controls replace-content` | Replace the entire content of a content control. |
| `doc.contentControls.clearContent` | `content-controls clear-content` | Clear all content inside a content control, leaving it empty. |
| `doc.contentControls.appendContent` | `content-controls append-content` | Append content to the end of a content control. |
| `doc.contentControls.prependContent` | `content-controls prepend-content` | Prepend content to the beginning of a content control. |
| `doc.contentControls.insertBefore` | `content-controls insert-before` | Insert content immediately before a content control. |
| `doc.contentControls.insertAfter` | `content-controls insert-after` | Insert content immediately after a content control. |
| `doc.contentControls.getBinding` | `content-controls get-binding` | Get the data binding metadata (w:dataBinding) of a content control. |
| `doc.contentControls.setBinding` | `content-controls set-binding` | Set data binding metadata on a content control. |
| `doc.contentControls.clearBinding` | `content-controls clear-binding` | Remove data binding metadata from a content control. |
| `doc.contentControls.getRawProperties` | `content-controls get-raw-properties` | Get the raw sdtPr properties of a content control as a passthrough hash. |
| `doc.contentControls.patchRawProperties` | `content-controls patch-raw-properties` | Apply raw XML-level patches to the sdtPr subtree of a content control. |
| `doc.contentControls.validateWordCompatibility` | `content-controls validate-word-compatibility` | Validate a content control for Word compatibility issues. |
| `doc.contentControls.normalizeWordCompatibility` | `content-controls normalize-word-compatibility` | Normalize a content control to resolve Word compatibility issues. |
| `doc.contentControls.normalizeTagPayload` | `content-controls normalize-tag-payload` | Normalize a content control tag between plain-string and JSON-encoded formats. |
| `doc.contentControls.text.setMultiline` | `content-controls text set-multiline` | Set or clear the multiline attribute on a plain-text content control. |
| `doc.contentControls.text.setValue` | `content-controls text set-value` | Set the text value of a plain-text content control. |
| `doc.contentControls.text.clearValue` | `content-controls text clear-value` | Clear the text value of a plain-text content control. |
| `doc.contentControls.date.setValue` | `content-controls date set-value` | Set the date value of a date content control. |
| `doc.contentControls.date.clearValue` | `content-controls date clear-value` | Clear the date value of a date content control. |
| `doc.contentControls.date.setDisplayFormat` | `content-controls date set-display-format` | Set the display format string for a date content control. |
| `doc.contentControls.date.setDisplayLocale` | `content-controls date set-display-locale` | Set the display locale for a date content control. |
| `doc.contentControls.date.setStorageFormat` | `content-controls date set-storage-format` | Set the XML storage format for a date content control. |
| `doc.contentControls.date.setCalendar` | `content-controls date set-calendar` | Set the calendar type for a date content control. |
| `doc.contentControls.checkbox.getState` | `content-controls checkbox get-state` | Get the checked state of a checkbox content control. |
| `doc.contentControls.checkbox.setState` | `content-controls checkbox set-state` | Set the checked state of a checkbox content control. |
| `doc.contentControls.checkbox.toggle` | `content-controls checkbox toggle` | Toggle the checked state of a checkbox content control. |
| `doc.contentControls.checkbox.setSymbolPair` | `content-controls checkbox set-symbol-pair` | Set the checked and unchecked symbol glyphs for a checkbox content control. |
| `doc.contentControls.choiceList.getItems` | `content-controls choice-list get-items` | Get the list items and selected value of a comboBox or dropDownList content control. |
| `doc.contentControls.choiceList.setItems` | `content-controls choice-list set-items` | Replace the list items of a comboBox or dropDownList content control. |
| `doc.contentControls.choiceList.setSelected` | `content-controls choice-list set-selected` | Set the selected value of a comboBox or dropDownList content control. |
| `doc.contentControls.repeatingSection.listItems` | `content-controls repeating-section list-items` | List the repeating section items inside a repeating section content control. |
| `doc.contentControls.repeatingSection.insertItemBefore` | `content-controls repeating-section insert-item-before` | Insert a new item before a specific index in a repeating section. |
| `doc.contentControls.repeatingSection.insertItemAfter` | `content-controls repeating-section insert-item-after` | Insert a new item after a specific index in a repeating section. |
| `doc.contentControls.repeatingSection.cloneItem` | `content-controls repeating-section clone-item` | Clone a repeating section item at the given index. Cloned SDTs receive new IDs. |
| `doc.contentControls.repeatingSection.deleteItem` | `content-controls repeating-section delete-item` | Delete a repeating section item at the given index. |
| `doc.contentControls.repeatingSection.setAllowInsertDelete` | `content-controls repeating-section set-allow-insert-delete` | Set the allowInsertDelete flag on a repeating section. |
| `doc.contentControls.group.wrap` | `content-controls group wrap` | Wrap a content control inside a new group content control. Always nests; not idempotent. |
| `doc.contentControls.group.ungroup` | `content-controls group ungroup` | Remove the group designation from a group content control. |
#### Format
| Operation | CLI command | Description |
| -------------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `doc.format.apply` | `format apply` | Apply inline run-property patch changes to the target range with explicit set/clear semantics. |
| `doc.format.bold` | `format bold` | Set or clear the `bold` inline run property on the target text range. |
| `doc.format.italic` | `format italic` | Set or clear the `italic` inline run property on the target text range. |
| `doc.format.strike` | `format strike` | Set or clear the `strike` inline run property on the target text range. |
| `doc.format.underline` | `format underline` | Set or clear the `underline` inline run property on the target text range. |
| `doc.format.highlight` | `format highlight` | Set or clear the `highlight` inline run property on the target text range. |
| `doc.format.color` | `format color` | Set or clear the `color` inline run property on the target text range. |
| `doc.format.fontSize` | `format font-size` | Set or clear the `fontSize` inline run property on the target text range. |
| `doc.format.fontFamily` | `format font-family` | Set or clear the `fontFamily` inline run property on the target text range. |
| `doc.format.letterSpacing` | `format letter-spacing` | Set or clear the `letterSpacing` inline run property on the target text range. |
| `doc.format.vertAlign` | `format vert-align` | Set or clear the `vertAlign` inline run property on the target text range. |
| `doc.format.position` | `format position` | Set or clear the `position` inline run property on the target text range. |
| `doc.format.dstrike` | `format dstrike` | Set or clear the `dstrike` inline run property on the target text range. |
| `doc.format.smallCaps` | `format small-caps` | Set or clear the `smallCaps` inline run property on the target text range. |
| `doc.format.caps` | `format caps` | Set or clear the `caps` inline run property on the target text range. |
| `doc.format.shading` | `format shading` | Set or clear the `shading` inline run property on the target text range. |
| `doc.format.border` | `format border` | Set or clear the `border` inline run property on the target text range. |
| `doc.format.outline` | `format outline` | Set or clear the `outline` inline run property on the target text range. |
| `doc.format.shadow` | `format shadow` | Set or clear the `shadow` inline run property on the target text range. |
| `doc.format.emboss` | `format emboss` | Set or clear the `emboss` inline run property on the target text range. |
| `doc.format.imprint` | `format imprint` | Set or clear the `imprint` inline run property on the target text range. |
| `doc.format.charScale` | `format char-scale` | Set or clear the `charScale` inline run property on the target text range. |
| `doc.format.kerning` | `format kerning` | Set or clear the `kerning` inline run property on the target text range. |
| `doc.format.vanish` | `format vanish` | Set or clear the `vanish` inline run property on the target text range. |
| `doc.format.webHidden` | `format web-hidden` | Set or clear the `webHidden` inline run property on the target text range. |
| `doc.format.specVanish` | `format spec-vanish` | Set or clear the `specVanish` inline run property on the target text range. |
| `doc.format.rtl` | `format rtl` | Set or clear the `rtl` inline run property on the target text range. |
| `doc.format.cs` | `format cs` | Set or clear the `cs` inline run property on the target text range. |
| `doc.format.bCs` | `format b-cs` | Set or clear the `bCs` inline run property on the target text range. |
| `doc.format.iCs` | `format i-cs` | Set or clear the `iCs` inline run property on the target text range. |
| `doc.format.eastAsianLayout` | `format east-asian-layout` | Set or clear the `eastAsianLayout` inline run property on the target text range. |
| `doc.format.em` | `format em` | Set or clear the `em` inline run property on the target text range. |
| `doc.format.fitText` | `format fit-text` | Set or clear the `fitText` inline run property on the target text range. |
| `doc.format.snapToGrid` | `format snap-to-grid` | Set or clear the `snapToGrid` inline run property on the target text range. |
| `doc.format.lang` | `format lang` | Set or clear the `lang` inline run property on the target text range. |
| `doc.format.oMath` | `format o-math` | Set or clear the `oMath` inline run property on the target text range. |
| `doc.format.rStyle` | `format r-style` | Set or clear the `rStyle` inline run property on the target text range. |
| `doc.format.rFonts` | `format r-fonts` | Set or clear the `rFonts` inline run property on the target text range. |
| `doc.format.fontSizeCs` | `format font-size-cs` | Set or clear the `fontSizeCs` inline run property on the target text range. |
| `doc.format.ligatures` | `format ligatures` | Set or clear the `ligatures` inline run property on the target text range. |
| `doc.format.numForm` | `format num-form` | Set or clear the `numForm` inline run property on the target text range. |
| `doc.format.numSpacing` | `format num-spacing` | Set or clear the `numSpacing` inline run property on the target text range. |
| `doc.format.stylisticSets` | `format stylistic-sets` | Set or clear the `stylisticSets` inline run property on the target text range. |
| `doc.format.contextualAlternates` | `format contextual-alternates` | Set or clear the `contextualAlternates` inline run property on the target text range. |
| `doc.styles.apply` | `styles apply` | Apply document-level default style changes to the stylesheet (word/styles.xml). Targets docDefaults run and paragraph channels with set-style patch semantics. |
| `doc.styles.paragraph.setStyle` | `styles paragraph set-style` | Set the paragraph style reference (w:pStyle) on a paragraph-like block. |
| `doc.styles.paragraph.clearStyle` | `styles paragraph clear-style` | Remove the paragraph style reference from a paragraph-like block. |
| `doc.format.paragraph.resetDirectFormatting` | `format paragraph reset-direct-formatting` | Strip all direct paragraph formatting while preserving style reference, numbering, and section metadata. |
| `doc.format.paragraph.setAlignment` | `format paragraph set-alignment` | Set paragraph alignment (justification) on a paragraph-like block. |
| `doc.format.paragraph.clearAlignment` | `format paragraph clear-alignment` | Remove direct paragraph alignment, reverting to style-defined or default alignment. |
| `doc.format.paragraph.setIndentation` | `format paragraph set-indentation` | Set paragraph indentation properties (left, right, firstLine, hanging) in twips. |
| `doc.format.paragraph.clearIndentation` | `format paragraph clear-indentation` | Remove all direct paragraph indentation. |
| `doc.format.paragraph.setSpacing` | `format paragraph set-spacing` | Set paragraph spacing properties (before, after, line, lineRule) in twips. |
| `doc.format.paragraph.clearSpacing` | `format paragraph clear-spacing` | Remove all direct paragraph spacing. |
| `doc.format.paragraph.setKeepOptions` | `format paragraph set-keep-options` | Set keep-with-next, keep-lines-together, and widow/orphan control flags. |
| `doc.format.paragraph.setOutlineLevel` | `format paragraph set-outline-level` | Set the paragraph outline level (0–9) or null to clear. |
| `doc.format.paragraph.setFlowOptions` | `format paragraph set-flow-options` | Set contextual spacing, page-break-before, and suppress-auto-hyphens flags. |
| `doc.format.paragraph.setTabStop` | `format paragraph set-tab-stop` | Add or replace a tab stop at a given position. |
| `doc.format.paragraph.clearTabStop` | `format paragraph clear-tab-stop` | Remove a tab stop at a given position. |
| `doc.format.paragraph.clearAllTabStops` | `format paragraph clear-all-tab-stops` | Remove all tab stops from a paragraph. |
| `doc.format.paragraph.setBorder` | `format paragraph set-border` | Set border properties for a specific side of a paragraph. |
| `doc.format.paragraph.clearBorder` | `format paragraph clear-border` | Remove border for a specific side or all sides of a paragraph. |
| `doc.format.paragraph.setShading` | `format paragraph set-shading` | Set paragraph shading (background fill, pattern color, pattern type). |
| `doc.format.paragraph.clearShading` | `format paragraph clear-shading` | Remove all paragraph shading. |
#### Create
| Operation | CLI command | Description |
| ---------------------------- | -------------------------- | --------------------------------------------------------------------------------------- |
| `doc.create.paragraph` | `create paragraph` | Create a new paragraph at the target position. |
| `doc.create.heading` | `create heading` | Create a new heading at the target position. |
| `doc.create.sectionBreak` | `create section-break` | Create a section break at the target location with optional initial section properties. |
| `doc.create.table` | `create table` | Create a new table at the target position. |
| `doc.create.tableOfContents` | `create table-of-contents` | Insert a new table of contents at the target position. |
| `doc.create.image` | `create image` | Insert a new image at the target position. |
#### Sections
| Operation | CLI command | Description |
| --------------------------------------- | --------------------------------------- | ------------------------------------------------------------------- |
| `doc.sections.list` | `sections list` | List sections in deterministic order with section-target handles. |
| `doc.sections.get` | `sections get` | Retrieve full section information by section address. |
| `doc.sections.setBreakType` | `sections set-break-type` | Set the section break type. |
| `doc.sections.setPageMargins` | `sections set-page-margins` | Set page-edge margins for a section. |
| `doc.sections.setHeaderFooterMargins` | `sections set-header-footer-margins` | Set header/footer margin distances for a section. |
| `doc.sections.setPageSetup` | `sections set-page-setup` | Set page size/orientation properties for a section. |
| `doc.sections.setColumns` | `sections set-columns` | Set column configuration for a section. |
| `doc.sections.setLineNumbering` | `sections set-line-numbering` | Enable or configure line numbering for a section. |
| `doc.sections.setPageNumbering` | `sections set-page-numbering` | Set page numbering format/start for a section. |
| `doc.sections.setTitlePage` | `sections set-title-page` | Enable or disable title-page behavior for a section. |
| `doc.sections.setOddEvenHeadersFooters` | `sections set-odd-even-headers-footers` | Enable or disable odd/even header-footer mode in document settings. |
| `doc.sections.setVerticalAlign` | `sections set-vertical-align` | Set vertical page alignment for a section. |
| `doc.sections.setSectionDirection` | `sections set-section-direction` | Set section text flow direction (LTR/RTL). |
| `doc.sections.setHeaderFooterRef` | `sections set-header-footer-ref` | Set or replace a section header/footer reference for a variant. |
| `doc.sections.clearHeaderFooterRef` | `sections clear-header-footer-ref` | Clear a section header/footer reference for a specific variant. |
| `doc.sections.setLinkToPrevious` | `sections set-link-to-previous` | Set or clear link-to-previous behavior for a header/footer variant. |
| `doc.sections.setPageBorders` | `sections set-page-borders` | Set page border configuration for a section. |
| `doc.sections.clearPageBorders` | `sections clear-page-borders` | Clear page border configuration for a section. |
#### Lists
| Operation | CLI command | Description |
| ------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| `doc.lists.list` | `lists list` | List all list nodes in the document, optionally filtered by scope. |
| `doc.lists.get` | `lists get` | Retrieve a specific list node by target. |
| `doc.lists.insert` | `lists insert` | Insert a new list at the target position. |
| `doc.lists.create` | `lists create` | Create a new list from one or more paragraphs, or convert existing paragraphs into a new list. |
| `doc.lists.attach` | `lists attach` | Convert non-list paragraphs to list items under an existing list sequence. |
| `doc.lists.detach` | `lists detach` | Remove numbering properties from list items, converting them to plain paragraphs. |
| `doc.lists.indent` | `lists indent` | Increase the indentation level of a list item. |
| `doc.lists.outdent` | `lists outdent` | Decrease the indentation level of a list item. |
| `doc.lists.join` | `lists join` | Merge two adjacent list sequences into one. |
| `doc.lists.canJoin` | `lists can-join` | Check whether two adjacent list sequences can be joined. |
| `doc.lists.separate` | `lists separate` | Split a list sequence at the target item, creating a new sequence from that point forward. |
| `doc.lists.setLevel` | `lists set-level` | Set the absolute nesting level (0..8) of a list item. |
| `doc.lists.setValue` | `lists set-value` | Set an explicit numbering value at the target item. Mid-sequence targets are atomically separated first. |
| `doc.lists.continuePrevious` | `lists continue-previous` | Continue numbering from the nearest compatible previous list sequence. |
| `doc.lists.canContinuePrevious` | `lists can-continue-previous` | Check whether the target sequence can continue numbering from a previous compatible sequence. |
| `doc.lists.setLevelRestart` | `lists set-level-restart` | Set the restart behavior for a specific list level. |
| `doc.lists.convertToText` | `lists convert-to-text` | Convert list items to plain paragraphs, optionally prepending the rendered marker text. |
| `doc.lists.applyTemplate` | `lists apply-template` | Apply a captured ListTemplate to the target list, optionally filtered to specific levels. |
| `doc.lists.applyPreset` | `lists apply-preset` | Apply a built-in list formatting preset to the target list. |
| `doc.lists.setType` | `lists set-type` | Convert a list to ordered or bullet and merge adjacent compatible sequences to preserve continuous numbering. |
| `doc.lists.captureTemplate` | `lists capture-template` | Capture the formatting of a list as a reusable ListTemplate. |
| `doc.lists.setLevelNumbering` | `lists set-level-numbering` | Set the numbering format, pattern, and optional start value for a specific list level. |
| `doc.lists.setLevelBullet` | `lists set-level-bullet` | Set the bullet marker text for a specific list level. |
| `doc.lists.setLevelPictureBullet` | `lists set-level-picture-bullet` | Set a picture bullet for a specific list level by its OOXML lvlPicBulletId. |
| `doc.lists.setLevelAlignment` | `lists set-level-alignment` | Set the marker alignment (left, center, right) for a specific list level. |
| `doc.lists.setLevelIndents` | `lists set-level-indents` | Set the paragraph indentation values (left, hanging, firstLine) for a specific list level. |
| `doc.lists.setLevelTrailingCharacter` | `lists set-level-trailing-character` | Set the trailing character (tab, space, nothing) after the marker for a specific list level. |
| `doc.lists.setLevelMarkerFont` | `lists set-level-marker-font` | Set the font family used for the marker character at a specific list level. |
| `doc.lists.clearLevelOverrides` | `lists clear-level-overrides` | Remove instance-level overrides for a specific list level, restoring abstract definition values. |
#### Tables
| Operation | CLI command | Description |
| ------------------------------ | ---------------------------- | --------------------------------------------------------------------------------- |
| `doc.tables.convertFromText` | `tables convert-from-text` | Convert a text range into a table. |
| `doc.tables.delete` | `tables delete` | Delete the target table from the document. |
| `doc.tables.clearContents` | `tables clear-contents` | Clear the contents of the target table or cell range. |
| `doc.tables.move` | `tables move` | Move a table to a new position in the document. |
| `doc.tables.split` | `tables split` | Split a table into two tables at the target row. |
| `doc.tables.convertToText` | `tables convert-to-text` | Convert a table back to plain text. |
| `doc.tables.setLayout` | `tables set-layout` | Set the layout mode of the target table. |
| `doc.tables.insertRow` | `tables insert-row` | Insert a new row into the target table. |
| `doc.tables.deleteRow` | `tables delete-row` | Delete a row from the target table. |
| `doc.tables.setRowHeight` | `tables set-row-height` | Set the height of a table row. |
| `doc.tables.distributeRows` | `tables distribute-rows` | Distribute row heights evenly across the target table. |
| `doc.tables.setRowOptions` | `tables set-row-options` | Set options on a table row such as header repeat or page break. |
| `doc.tables.insertColumn` | `tables insert-column` | Insert a new column into the target table. |
| `doc.tables.deleteColumn` | `tables delete-column` | Delete a column from the target table. |
| `doc.tables.setColumnWidth` | `tables set-column-width` | Set the width of a table column. |
| `doc.tables.distributeColumns` | `tables distribute-columns` | Distribute column widths evenly across the target table. |
| `doc.tables.insertCell` | `tables insert-cell` | Insert a new cell into a table row. |
| `doc.tables.deleteCell` | `tables delete-cell` | Delete a cell from a table row. |
| `doc.tables.mergeCells` | `tables merge-cells` | Merge a range of table cells into one. |
| `doc.tables.unmergeCells` | `tables unmerge-cells` | Unmerge a previously merged table cell. |
| `doc.tables.splitCell` | `tables split-cell` | Split a table cell into multiple cells. |
| `doc.tables.setCellProperties` | `tables set-cell-properties` | Set properties on a table cell such as vertical alignment or text direction. |
| `doc.tables.sort` | `tables sort` | Sort table rows by a column value. |
| `doc.tables.setAltText` | `tables set-alt-text` | Set the alternative text description for a table. |
| `doc.tables.setStyle` | `tables set-style` | Apply a named table style to the target table. |
| `doc.tables.clearStyle` | `tables clear-style` | Remove the applied table style, reverting to defaults. |
| `doc.tables.setStyleOption` | `tables set-style-option` | Toggle a conditional style option such as banded rows or first column. |
| `doc.tables.setBorder` | `tables set-border` | Set border properties on a table or cell range. |
| `doc.tables.clearBorder` | `tables clear-border` | Remove border formatting from a table or cell range. |
| `doc.tables.applyBorderPreset` | `tables apply-border-preset` | Apply a border preset (e.g. all borders, outside only) to a table. |
| `doc.tables.setShading` | `tables set-shading` | Set the background shading color on a table or cell range. |
| `doc.tables.clearShading` | `tables clear-shading` | Remove shading from a table or cell range. |
| `doc.tables.setTablePadding` | `tables set-table-padding` | Set default cell padding for the entire table. |
| `doc.tables.setCellPadding` | `tables set-cell-padding` | Set padding on a specific table cell or cell range. |
| `doc.tables.setCellSpacing` | `tables set-cell-spacing` | Set the cell spacing for the target table. |
| `doc.tables.clearCellSpacing` | `tables clear-cell-spacing` | Remove custom cell spacing from the target table. |
| `doc.tables.get` | `tables get` | Retrieve table structure and dimensions by locator. |
| `doc.tables.getCells` | `tables get-cells` | Retrieve cell information for a table, optionally filtered by row or column. |
| `doc.tables.getProperties` | `tables get-properties` | Retrieve layout and style properties of a table. |
| `doc.tables.getStyles` | `tables get-styles` | List all table styles and the document-level default table style setting. |
| `doc.tables.setDefaultStyle` | `tables set-default-style` | Set the document-level default table style (w:defaultTableStyle in settings.xml). |
| `doc.tables.clearDefaultStyle` | `tables clear-default-style` | Remove the document-level default table style setting. |
#### Table of contents
| Operation | CLI command | Description |
| --------------------- | ------------------ | -------------------------------------------------------------------- |
| `doc.toc.list` | `toc list` | List all tables of contents in the document. |
| `doc.toc.get` | `toc get` | Retrieve details of a specific table of contents. |
| `doc.toc.configure` | `toc configure` | Update the configuration switches of a table of contents. |
| `doc.toc.update` | `toc update` | Rebuild or refresh the materialized content of a table of contents. |
| `doc.toc.remove` | `toc remove` | Remove a table of contents from the document. |
| `doc.toc.markEntry` | `toc mark-entry` | Insert a TC (table of contents entry) field at the target paragraph. |
| `doc.toc.unmarkEntry` | `toc unmark-entry` | Remove a TC (table of contents entry) field from the document. |
| `doc.toc.listEntries` | `toc list-entries` | List all TC (table of contents entry) fields in the document body. |
| `doc.toc.getEntry` | `toc get-entry` | Retrieve details of a specific TC (table of contents entry) field. |
| `doc.toc.editEntry` | `toc edit-entry` | Update the properties of a TC (table of contents entry) field. |
#### Images
| Operation | CLI command | Description |
| ------------------------------- | ------------------------------ | ----------------------------------------------------------------- |
| `doc.images.list` | `images list` | List all images in the document. |
| `doc.images.get` | `images get` | Get details for a specific image by its stable ID. |
| `doc.images.delete` | `images delete` | Delete an image from the document. |
| `doc.images.move` | `images move` | Move an image to a new location in the document. |
| `doc.images.convertToInline` | `images convert-to-inline` | Convert a floating image to inline placement. |
| `doc.images.convertToFloating` | `images convert-to-floating` | Convert an inline image to floating placement. |
| `doc.images.setSize` | `images set-size` | Set explicit width/height for an image. |
| `doc.images.setWrapType` | `images set-wrap-type` | Set the text wrapping type for a floating image. |
| `doc.images.setWrapSide` | `images set-wrap-side` | Set which side(s) text wraps around a floating image. |
| `doc.images.setWrapDistances` | `images set-wrap-distances` | Set the text-wrap distance margins for a floating image. |
| `doc.images.setPosition` | `images set-position` | Set the anchor position for a floating image. |
| `doc.images.setAnchorOptions` | `images set-anchor-options` | Set anchor behavior options for a floating image. |
| `doc.images.setZOrder` | `images set-z-order` | Set the z-order (relativeHeight) for a floating image. |
| `doc.images.scale` | `images scale` | Scale an image by a uniform factor applied to both dimensions. |
| `doc.images.setLockAspectRatio` | `images set-lock-aspect-ratio` | Lock or unlock the aspect ratio for an image. |
| `doc.images.rotate` | `images rotate` | Set the absolute rotation angle for an image. |
| `doc.images.flip` | `images flip` | Set horizontal and/or vertical flip state for an image. |
| `doc.images.crop` | `images crop` | Apply rectangular edge-percentage crop to an image. |
| `doc.images.resetCrop` | `images reset-crop` | Remove all cropping from an image. |
| `doc.images.replaceSource` | `images replace-source` | Replace the image source while preserving identity and placement. |
| `doc.images.setAltText` | `images set-alt-text` | Set the accessibility description (alt text) for an image. |
| `doc.images.setDecorative` | `images set-decorative` | Mark or unmark an image as decorative. |
| `doc.images.setName` | `images set-name` | Set the object name for an image. |
| `doc.images.setHyperlink` | `images set-hyperlink` | Set or remove the hyperlink attached to an image. |
| `doc.images.insertCaption` | `images insert-caption` | Insert a caption paragraph below the image. |
| `doc.images.updateCaption` | `images update-caption` | Update the text of an existing caption paragraph. |
| `doc.images.removeCaption` | `images remove-caption` | Remove the caption paragraph from below the image. |
#### Comments
| Operation | CLI command | Description |
| --------------------- | ----------------- | -------------------------------------------------------------------------- |
| `doc.comments.create` | `comments create` | Create a new comment thread (or reply when parentCommentId is given). |
| `doc.comments.patch` | `comments patch` | Patch fields on an existing comment (text, target, status, or isInternal). |
| `doc.comments.delete` | `comments delete` | Remove a comment or reply by ID. |
| `doc.comments.get` | `comments get` | Retrieve a single comment thread by ID. |
| `doc.comments.list` | `comments list` | List all comment threads in the document. |
#### Track changes
| Operation | CLI command | Description |
| ------------------------- | ---------------------- | -------------------------------------------------------- |
| `doc.trackChanges.list` | `track-changes list` | List all tracked changes in the document. |
| `doc.trackChanges.get` | `track-changes get` | Retrieve a single tracked change by ID. |
| `doc.trackChanges.decide` | `track-changes decide` | Accept or reject a tracked change (by ID or scope: all). |
#### History
| Operation | CLI command | Description |
| ------------------ | -------------- | ---------------------------------------------------------------- |
| `doc.history.get` | `history get` | Query the current undo/redo history state of the active editor. |
| `doc.history.undo` | `history undo` | Undo the most recent history-safe mutation in the active editor. |
| `doc.history.redo` | `history redo` | Redo the most recently undone action in the active editor. |
#### Session
| Operation | CLI command | Description |
| ------------------------ | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `doc.open` | `open` | Open a document and create a persistent editing session. Optionally override the document body with contentOverride + overrideType (markdown, html, or text). |
| `doc.save` | `save` | Save the current session to the original file or a new path. |
| `doc.close` | `close` | Close the active editing session and clean up resources. |
| `doc.status` | `status` | Show the current session status and document metadata. |
| `doc.describe` | `describe` | List all available CLI operations and contract metadata. |
| `doc.describeCommand` | `describe command` | Show detailed metadata for a single CLI operation. |
| `doc.session.list` | `session list` | List all active editing sessions. |
| `doc.session.save` | `session save` | Persist the current session state. |
| `doc.session.close` | `session close` | Close a specific editing session by ID. |
| `doc.session.setDefault` | `session set-default` | Set the default session for subsequent commands. |
#### Core
| Operation | CLI command | Description |
| ---------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `doc.get` | `get` | Read the full document as an SDDocument structure. |
| `doc.find` | `find` | Search the document for text or node matches using SDM/1 selectors. |
| `doc.get_node` | `get-node` | Retrieve a single node by target position. |
| `doc.get_node_by_id` | `get-node-by-id` | Retrieve a single node by its unique ID. |
| `doc.get_text` | `get-text` | Extract the plain-text content of the document. |
| `doc.get_markdown` | `get-markdown` | Extract the document content as a Markdown string. |
| `doc.get_html` | `get-html` | Extract the document content as an HTML string. |
| `doc.markdown_to_fragment` | `markdown-to-fragment` | Convert a Markdown string into an SDM/1 structural fragment. |
| `doc.info` | `info` | Return document metadata including revision, node count, and capabilities. |
| `doc.clear_content` | `clear-content` | Clear all document body content, leaving a single empty paragraph. |
| `doc.insert` | `insert` | Insert content at a target position, or at the end of the document when target is omitted. Accepts two input shapes: legacy string-based (value + type) or structural SDFragment (content). Supports text (default), markdown, and html content types via the `type` field in legacy mode. Structural mode accepts an SDFragment with typed nodes (paragraphs, tables, images, etc.). |
| `doc.replace` | `replace` | Replace content at a target position with new content. Accepts two input shapes: legacy string-based (text) or structural SDFragment (content). Structural mode replaces the target range with typed nodes (paragraphs, tables, images, etc.). |
| `doc.delete` | `delete` | Delete content at a target position. |
| `doc.blocks.delete` | `blocks delete` | Delete an entire block node (paragraph, heading, list item, table, image, or sdt) deterministically. |
| `doc.query.match` | `query match` | Deterministic selector-based search with cardinality contracts for mutation targeting. |
| `doc.mutations.preview` | `mutations preview` | Dry-run a mutation plan, returning resolved targets without applying changes. |
| `doc.mutations.apply` | `mutations apply` | Execute a mutation plan atomically against the document. |
| `doc.capabilities.get` | `capabilities` | Query runtime capabilities supported by the current document engine. |
| `doc.hyperlinks.list` | `hyperlinks list` | List all hyperlinks in the document, with optional filtering by href, anchor, or display text. |
| `doc.hyperlinks.get` | `hyperlinks get` | Retrieve details of a specific hyperlink by its inline address. |
| `doc.hyperlinks.wrap` | `hyperlinks wrap` | Wrap an existing text range with a hyperlink. |
| `doc.hyperlinks.insert` | `hyperlinks insert` | Insert new linked text at a target position. |
| `doc.hyperlinks.patch` | `hyperlinks patch` | Update hyperlink metadata (destination, tooltip, target, rel) without changing display text. |
| `doc.hyperlinks.remove` | `hyperlinks remove` | Remove a hyperlink. Mode 'unwrap' preserves display text; 'deleteText' removes the linked content entirely. |
| `doc.create.content_control` | `create content-control` | Create a new content control (SDT) in the document. |
| `doc.content_controls.list` | `content-controls list` | List all content controls in the document with optional type/tag filtering. |
| `doc.content_controls.get` | `content-controls get` | Retrieve a single content control by target. |
| `doc.content_controls.list_in_range` | `content-controls list-in-range` | List content controls within a block range. |
| `doc.content_controls.select_by_tag` | `content-controls select-by-tag` | Select content controls matching a specific tag value. |
| `doc.content_controls.select_by_title` | `content-controls select-by-title` | Select content controls matching a specific title (alias) value. |
| `doc.content_controls.list_children` | `content-controls list-children` | List direct child content controls nested inside the target. |
| `doc.content_controls.get_parent` | `content-controls get-parent` | Get the parent content control of the target, if any. |
| `doc.content_controls.wrap` | `content-controls wrap` | Wrap existing content with a new content control. |
| `doc.content_controls.unwrap` | `content-controls unwrap` | Remove the content control wrapper, preserving its content in place. |
| `doc.content_controls.delete` | `content-controls delete` | Delete a content control and its content from the document. |
| `doc.content_controls.copy` | `content-controls copy` | Copy a content control to a destination position. Copied SDTs receive new IDs. |
| `doc.content_controls.move` | `content-controls move` | Move a content control to a new position. Preserves original IDs. |
| `doc.content_controls.patch` | `content-controls patch` | Patch metadata properties on a content control (tag, alias, appearance, color, etc.). |
| `doc.content_controls.set_lock_mode` | `content-controls set-lock-mode` | Set the lock mode on a content control. |
| `doc.content_controls.set_type` | `content-controls set-type` | Transition a content control to a different semantic type. Metadata-only; no implicit content rewrite. |
| `doc.content_controls.get_content` | `content-controls get-content` | Get the text content of a content control. |
| `doc.content_controls.replace_content` | `content-controls replace-content` | Replace the entire content of a content control. |
| `doc.content_controls.clear_content` | `content-controls clear-content` | Clear all content inside a content control, leaving it empty. |
| `doc.content_controls.append_content` | `content-controls append-content` | Append content to the end of a content control. |
| `doc.content_controls.prepend_content` | `content-controls prepend-content` | Prepend content to the beginning of a content control. |
| `doc.content_controls.insert_before` | `content-controls insert-before` | Insert content immediately before a content control. |
| `doc.content_controls.insert_after` | `content-controls insert-after` | Insert content immediately after a content control. |
| `doc.content_controls.get_binding` | `content-controls get-binding` | Get the data binding metadata (w:dataBinding) of a content control. |
| `doc.content_controls.set_binding` | `content-controls set-binding` | Set data binding metadata on a content control. |
| `doc.content_controls.clear_binding` | `content-controls clear-binding` | Remove data binding metadata from a content control. |
| `doc.content_controls.get_raw_properties` | `content-controls get-raw-properties` | Get the raw sdtPr properties of a content control as a passthrough hash. |
| `doc.content_controls.patch_raw_properties` | `content-controls patch-raw-properties` | Apply raw XML-level patches to the sdtPr subtree of a content control. |
| `doc.content_controls.validate_word_compatibility` | `content-controls validate-word-compatibility` | Validate a content control for Word compatibility issues. |
| `doc.content_controls.normalize_word_compatibility` | `content-controls normalize-word-compatibility` | Normalize a content control to resolve Word compatibility issues. |
| `doc.content_controls.normalize_tag_payload` | `content-controls normalize-tag-payload` | Normalize a content control tag between plain-string and JSON-encoded formats. |
| `doc.content_controls.text.set_multiline` | `content-controls text set-multiline` | Set or clear the multiline attribute on a plain-text content control. |
| `doc.content_controls.text.set_value` | `content-controls text set-value` | Set the text value of a plain-text content control. |
| `doc.content_controls.text.clear_value` | `content-controls text clear-value` | Clear the text value of a plain-text content control. |
| `doc.content_controls.date.set_value` | `content-controls date set-value` | Set the date value of a date content control. |
| `doc.content_controls.date.clear_value` | `content-controls date clear-value` | Clear the date value of a date content control. |
| `doc.content_controls.date.set_display_format` | `content-controls date set-display-format` | Set the display format string for a date content control. |
| `doc.content_controls.date.set_display_locale` | `content-controls date set-display-locale` | Set the display locale for a date content control. |
| `doc.content_controls.date.set_storage_format` | `content-controls date set-storage-format` | Set the XML storage format for a date content control. |
| `doc.content_controls.date.set_calendar` | `content-controls date set-calendar` | Set the calendar type for a date content control. |
| `doc.content_controls.checkbox.get_state` | `content-controls checkbox get-state` | Get the checked state of a checkbox content control. |
| `doc.content_controls.checkbox.set_state` | `content-controls checkbox set-state` | Set the checked state of a checkbox content control. |
| `doc.content_controls.checkbox.toggle` | `content-controls checkbox toggle` | Toggle the checked state of a checkbox content control. |
| `doc.content_controls.checkbox.set_symbol_pair` | `content-controls checkbox set-symbol-pair` | Set the checked and unchecked symbol glyphs for a checkbox content control. |
| `doc.content_controls.choice_list.get_items` | `content-controls choice-list get-items` | Get the list items and selected value of a comboBox or dropDownList content control. |
| `doc.content_controls.choice_list.set_items` | `content-controls choice-list set-items` | Replace the list items of a comboBox or dropDownList content control. |
| `doc.content_controls.choice_list.set_selected` | `content-controls choice-list set-selected` | Set the selected value of a comboBox or dropDownList content control. |
| `doc.content_controls.repeating_section.list_items` | `content-controls repeating-section list-items` | List the repeating section items inside a repeating section content control. |
| `doc.content_controls.repeating_section.insert_item_before` | `content-controls repeating-section insert-item-before` | Insert a new item before a specific index in a repeating section. |
| `doc.content_controls.repeating_section.insert_item_after` | `content-controls repeating-section insert-item-after` | Insert a new item after a specific index in a repeating section. |
| `doc.content_controls.repeating_section.clone_item` | `content-controls repeating-section clone-item` | Clone a repeating section item at the given index. Cloned SDTs receive new IDs. |
| `doc.content_controls.repeating_section.delete_item` | `content-controls repeating-section delete-item` | Delete a repeating section item at the given index. |
| `doc.content_controls.repeating_section.set_allow_insert_delete` | `content-controls repeating-section set-allow-insert-delete` | Set the allowInsertDelete flag on a repeating section. |
| `doc.content_controls.group.wrap` | `content-controls group wrap` | Wrap a content control inside a new group content control. Always nests; not idempotent. |
| `doc.content_controls.group.ungroup` | `content-controls group ungroup` | Remove the group designation from a group content control. |
#### Format
| Operation | CLI command | Description |
| ---------------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `doc.format.apply` | `format apply` | Apply inline run-property patch changes to the target range with explicit set/clear semantics. |
| `doc.format.bold` | `format bold` | Set or clear the `bold` inline run property on the target text range. |
| `doc.format.italic` | `format italic` | Set or clear the `italic` inline run property on the target text range. |
| `doc.format.strike` | `format strike` | Set or clear the `strike` inline run property on the target text range. |
| `doc.format.underline` | `format underline` | Set or clear the `underline` inline run property on the target text range. |
| `doc.format.highlight` | `format highlight` | Set or clear the `highlight` inline run property on the target text range. |
| `doc.format.color` | `format color` | Set or clear the `color` inline run property on the target text range. |
| `doc.format.font_size` | `format font-size` | Set or clear the `fontSize` inline run property on the target text range. |
| `doc.format.font_family` | `format font-family` | Set or clear the `fontFamily` inline run property on the target text range. |
| `doc.format.letter_spacing` | `format letter-spacing` | Set or clear the `letterSpacing` inline run property on the target text range. |
| `doc.format.vert_align` | `format vert-align` | Set or clear the `vertAlign` inline run property on the target text range. |
| `doc.format.position` | `format position` | Set or clear the `position` inline run property on the target text range. |
| `doc.format.dstrike` | `format dstrike` | Set or clear the `dstrike` inline run property on the target text range. |
| `doc.format.small_caps` | `format small-caps` | Set or clear the `smallCaps` inline run property on the target text range. |
| `doc.format.caps` | `format caps` | Set or clear the `caps` inline run property on the target text range. |
| `doc.format.shading` | `format shading` | Set or clear the `shading` inline run property on the target text range. |
| `doc.format.border` | `format border` | Set or clear the `border` inline run property on the target text range. |
| `doc.format.outline` | `format outline` | Set or clear the `outline` inline run property on the target text range. |
| `doc.format.shadow` | `format shadow` | Set or clear the `shadow` inline run property on the target text range. |
| `doc.format.emboss` | `format emboss` | Set or clear the `emboss` inline run property on the target text range. |
| `doc.format.imprint` | `format imprint` | Set or clear the `imprint` inline run property on the target text range. |
| `doc.format.char_scale` | `format char-scale` | Set or clear the `charScale` inline run property on the target text range. |
| `doc.format.kerning` | `format kerning` | Set or clear the `kerning` inline run property on the target text range. |
| `doc.format.vanish` | `format vanish` | Set or clear the `vanish` inline run property on the target text range. |
| `doc.format.web_hidden` | `format web-hidden` | Set or clear the `webHidden` inline run property on the target text range. |
| `doc.format.spec_vanish` | `format spec-vanish` | Set or clear the `specVanish` inline run property on the target text range. |
| `doc.format.rtl` | `format rtl` | Set or clear the `rtl` inline run property on the target text range. |
| `doc.format.cs` | `format cs` | Set or clear the `cs` inline run property on the target text range. |
| `doc.format.b_cs` | `format b-cs` | Set or clear the `bCs` inline run property on the target text range. |
| `doc.format.i_cs` | `format i-cs` | Set or clear the `iCs` inline run property on the target text range. |
| `doc.format.east_asian_layout` | `format east-asian-layout` | Set or clear the `eastAsianLayout` inline run property on the target text range. |
| `doc.format.em` | `format em` | Set or clear the `em` inline run property on the target text range. |
| `doc.format.fit_text` | `format fit-text` | Set or clear the `fitText` inline run property on the target text range. |
| `doc.format.snap_to_grid` | `format snap-to-grid` | Set or clear the `snapToGrid` inline run property on the target text range. |
| `doc.format.lang` | `format lang` | Set or clear the `lang` inline run property on the target text range. |
| `doc.format.o_math` | `format o-math` | Set or clear the `oMath` inline run property on the target text range. |
| `doc.format.r_style` | `format r-style` | Set or clear the `rStyle` inline run property on the target text range. |
| `doc.format.r_fonts` | `format r-fonts` | Set or clear the `rFonts` inline run property on the target text range. |
| `doc.format.font_size_cs` | `format font-size-cs` | Set or clear the `fontSizeCs` inline run property on the target text range. |
| `doc.format.ligatures` | `format ligatures` | Set or clear the `ligatures` inline run property on the target text range. |
| `doc.format.num_form` | `format num-form` | Set or clear the `numForm` inline run property on the target text range. |
| `doc.format.num_spacing` | `format num-spacing` | Set or clear the `numSpacing` inline run property on the target text range. |
| `doc.format.stylistic_sets` | `format stylistic-sets` | Set or clear the `stylisticSets` inline run property on the target text range. |
| `doc.format.contextual_alternates` | `format contextual-alternates` | Set or clear the `contextualAlternates` inline run property on the target text range. |
| `doc.styles.apply` | `styles apply` | Apply document-level default style changes to the stylesheet (word/styles.xml). Targets docDefaults run and paragraph channels with set-style patch semantics. |
| `doc.styles.paragraph.set_style` | `styles paragraph set-style` | Set the paragraph style reference (w:pStyle) on a paragraph-like block. |
| `doc.styles.paragraph.clear_style` | `styles paragraph clear-style` | Remove the paragraph style reference from a paragraph-like block. |
| `doc.format.paragraph.reset_direct_formatting` | `format paragraph reset-direct-formatting` | Strip all direct paragraph formatting while preserving style reference, numbering, and section metadata. |
| `doc.format.paragraph.set_alignment` | `format paragraph set-alignment` | Set paragraph alignment (justification) on a paragraph-like block. |
| `doc.format.paragraph.clear_alignment` | `format paragraph clear-alignment` | Remove direct paragraph alignment, reverting to style-defined or default alignment. |
| `doc.format.paragraph.set_indentation` | `format paragraph set-indentation` | Set paragraph indentation properties (left, right, firstLine, hanging) in twips. |
| `doc.format.paragraph.clear_indentation` | `format paragraph clear-indentation` | Remove all direct paragraph indentation. |
| `doc.format.paragraph.set_spacing` | `format paragraph set-spacing` | Set paragraph spacing properties (before, after, line, lineRule) in twips. |
| `doc.format.paragraph.clear_spacing` | `format paragraph clear-spacing` | Remove all direct paragraph spacing. |
| `doc.format.paragraph.set_keep_options` | `format paragraph set-keep-options` | Set keep-with-next, keep-lines-together, and widow/orphan control flags. |
| `doc.format.paragraph.set_outline_level` | `format paragraph set-outline-level` | Set the paragraph outline level (0–9) or null to clear. |
| `doc.format.paragraph.set_flow_options` | `format paragraph set-flow-options` | Set contextual spacing, page-break-before, and suppress-auto-hyphens flags. |
| `doc.format.paragraph.set_tab_stop` | `format paragraph set-tab-stop` | Add or replace a tab stop at a given position. |
| `doc.format.paragraph.clear_tab_stop` | `format paragraph clear-tab-stop` | Remove a tab stop at a given position. |
| `doc.format.paragraph.clear_all_tab_stops` | `format paragraph clear-all-tab-stops` | Remove all tab stops from a paragraph. |
| `doc.format.paragraph.set_border` | `format paragraph set-border` | Set border properties for a specific side of a paragraph. |
| `doc.format.paragraph.clear_border` | `format paragraph clear-border` | Remove border for a specific side or all sides of a paragraph. |
| `doc.format.paragraph.set_shading` | `format paragraph set-shading` | Set paragraph shading (background fill, pattern color, pattern type). |
| `doc.format.paragraph.clear_shading` | `format paragraph clear-shading` | Remove all paragraph shading. |
#### Create
| Operation | CLI command | Description |
| ------------------------------ | -------------------------- | --------------------------------------------------------------------------------------- |
| `doc.create.paragraph` | `create paragraph` | Create a new paragraph at the target position. |
| `doc.create.heading` | `create heading` | Create a new heading at the target position. |
| `doc.create.section_break` | `create section-break` | Create a section break at the target location with optional initial section properties. |
| `doc.create.table` | `create table` | Create a new table at the target position. |
| `doc.create.table_of_contents` | `create table-of-contents` | Insert a new table of contents at the target position. |
| `doc.create.image` | `create image` | Insert a new image at the target position. |
#### Sections
| Operation | CLI command | Description |
| ------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------- |
| `doc.sections.list` | `sections list` | List sections in deterministic order with section-target handles. |
| `doc.sections.get` | `sections get` | Retrieve full section information by section address. |
| `doc.sections.set_break_type` | `sections set-break-type` | Set the section break type. |
| `doc.sections.set_page_margins` | `sections set-page-margins` | Set page-edge margins for a section. |
| `doc.sections.set_header_footer_margins` | `sections set-header-footer-margins` | Set header/footer margin distances for a section. |
| `doc.sections.set_page_setup` | `sections set-page-setup` | Set page size/orientation properties for a section. |
| `doc.sections.set_columns` | `sections set-columns` | Set column configuration for a section. |
| `doc.sections.set_line_numbering` | `sections set-line-numbering` | Enable or configure line numbering for a section. |
| `doc.sections.set_page_numbering` | `sections set-page-numbering` | Set page numbering format/start for a section. |
| `doc.sections.set_title_page` | `sections set-title-page` | Enable or disable title-page behavior for a section. |
| `doc.sections.set_odd_even_headers_footers` | `sections set-odd-even-headers-footers` | Enable or disable odd/even header-footer mode in document settings. |
| `doc.sections.set_vertical_align` | `sections set-vertical-align` | Set vertical page alignment for a section. |
| `doc.sections.set_section_direction` | `sections set-section-direction` | Set section text flow direction (LTR/RTL). |
| `doc.sections.set_header_footer_ref` | `sections set-header-footer-ref` | Set or replace a section header/footer reference for a variant. |
| `doc.sections.clear_header_footer_ref` | `sections clear-header-footer-ref` | Clear a section header/footer reference for a specific variant. |
| `doc.sections.set_link_to_previous` | `sections set-link-to-previous` | Set or clear link-to-previous behavior for a header/footer variant. |
| `doc.sections.set_page_borders` | `sections set-page-borders` | Set page border configuration for a section. |
| `doc.sections.clear_page_borders` | `sections clear-page-borders` | Clear page border configuration for a section. |
#### Lists
| Operation | CLI command | Description |
| ---------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| `doc.lists.list` | `lists list` | List all list nodes in the document, optionally filtered by scope. |
| `doc.lists.get` | `lists get` | Retrieve a specific list node by target. |
| `doc.lists.insert` | `lists insert` | Insert a new list at the target position. |
| `doc.lists.create` | `lists create` | Create a new list from one or more paragraphs, or convert existing paragraphs into a new list. |
| `doc.lists.attach` | `lists attach` | Convert non-list paragraphs to list items under an existing list sequence. |
| `doc.lists.detach` | `lists detach` | Remove numbering properties from list items, converting them to plain paragraphs. |
| `doc.lists.indent` | `lists indent` | Increase the indentation level of a list item. |
| `doc.lists.outdent` | `lists outdent` | Decrease the indentation level of a list item. |
| `doc.lists.join` | `lists join` | Merge two adjacent list sequences into one. |
| `doc.lists.can_join` | `lists can-join` | Check whether two adjacent list sequences can be joined. |
| `doc.lists.separate` | `lists separate` | Split a list sequence at the target item, creating a new sequence from that point forward. |
| `doc.lists.set_level` | `lists set-level` | Set the absolute nesting level (0..8) of a list item. |
| `doc.lists.set_value` | `lists set-value` | Set an explicit numbering value at the target item. Mid-sequence targets are atomically separated first. |
| `doc.lists.continue_previous` | `lists continue-previous` | Continue numbering from the nearest compatible previous list sequence. |
| `doc.lists.can_continue_previous` | `lists can-continue-previous` | Check whether the target sequence can continue numbering from a previous compatible sequence. |
| `doc.lists.set_level_restart` | `lists set-level-restart` | Set the restart behavior for a specific list level. |
| `doc.lists.convert_to_text` | `lists convert-to-text` | Convert list items to plain paragraphs, optionally prepending the rendered marker text. |
| `doc.lists.apply_template` | `lists apply-template` | Apply a captured ListTemplate to the target list, optionally filtered to specific levels. |
| `doc.lists.apply_preset` | `lists apply-preset` | Apply a built-in list formatting preset to the target list. |
| `doc.lists.set_type` | `lists set-type` | Convert a list to ordered or bullet and merge adjacent compatible sequences to preserve continuous numbering. |
| `doc.lists.capture_template` | `lists capture-template` | Capture the formatting of a list as a reusable ListTemplate. |
| `doc.lists.set_level_numbering` | `lists set-level-numbering` | Set the numbering format, pattern, and optional start value for a specific list level. |
| `doc.lists.set_level_bullet` | `lists set-level-bullet` | Set the bullet marker text for a specific list level. |
| `doc.lists.set_level_picture_bullet` | `lists set-level-picture-bullet` | Set a picture bullet for a specific list level by its OOXML lvlPicBulletId. |
| `doc.lists.set_level_alignment` | `lists set-level-alignment` | Set the marker alignment (left, center, right) for a specific list level. |
| `doc.lists.set_level_indents` | `lists set-level-indents` | Set the paragraph indentation values (left, hanging, firstLine) for a specific list level. |
| `doc.lists.set_level_trailing_character` | `lists set-level-trailing-character` | Set the trailing character (tab, space, nothing) after the marker for a specific list level. |
| `doc.lists.set_level_marker_font` | `lists set-level-marker-font` | Set the font family used for the marker character at a specific list level. |
| `doc.lists.clear_level_overrides` | `lists clear-level-overrides` | Remove instance-level overrides for a specific list level, restoring abstract definition values. |
#### Tables
| Operation | CLI command | Description |
| -------------------------------- | ---------------------------- | --------------------------------------------------------------------------------- |
| `doc.tables.convert_from_text` | `tables convert-from-text` | Convert a text range into a table. |
| `doc.tables.delete` | `tables delete` | Delete the target table from the document. |
| `doc.tables.clear_contents` | `tables clear-contents` | Clear the contents of the target table or cell range. |
| `doc.tables.move` | `tables move` | Move a table to a new position in the document. |
| `doc.tables.split` | `tables split` | Split a table into two tables at the target row. |
| `doc.tables.convert_to_text` | `tables convert-to-text` | Convert a table back to plain text. |
| `doc.tables.set_layout` | `tables set-layout` | Set the layout mode of the target table. |
| `doc.tables.insert_row` | `tables insert-row` | Insert a new row into the target table. |
| `doc.tables.delete_row` | `tables delete-row` | Delete a row from the target table. |
| `doc.tables.set_row_height` | `tables set-row-height` | Set the height of a table row. |
| `doc.tables.distribute_rows` | `tables distribute-rows` | Distribute row heights evenly across the target table. |
| `doc.tables.set_row_options` | `tables set-row-options` | Set options on a table row such as header repeat or page break. |
| `doc.tables.insert_column` | `tables insert-column` | Insert a new column into the target table. |
| `doc.tables.delete_column` | `tables delete-column` | Delete a column from the target table. |
| `doc.tables.set_column_width` | `tables set-column-width` | Set the width of a table column. |
| `doc.tables.distribute_columns` | `tables distribute-columns` | Distribute column widths evenly across the target table. |
| `doc.tables.insert_cell` | `tables insert-cell` | Insert a new cell into a table row. |
| `doc.tables.delete_cell` | `tables delete-cell` | Delete a cell from a table row. |
| `doc.tables.merge_cells` | `tables merge-cells` | Merge a range of table cells into one. |
| `doc.tables.unmerge_cells` | `tables unmerge-cells` | Unmerge a previously merged table cell. |
| `doc.tables.split_cell` | `tables split-cell` | Split a table cell into multiple cells. |
| `doc.tables.set_cell_properties` | `tables set-cell-properties` | Set properties on a table cell such as vertical alignment or text direction. |
| `doc.tables.sort` | `tables sort` | Sort table rows by a column value. |
| `doc.tables.set_alt_text` | `tables set-alt-text` | Set the alternative text description for a table. |
| `doc.tables.set_style` | `tables set-style` | Apply a named table style to the target table. |
| `doc.tables.clear_style` | `tables clear-style` | Remove the applied table style, reverting to defaults. |
| `doc.tables.set_style_option` | `tables set-style-option` | Toggle a conditional style option such as banded rows or first column. |
| `doc.tables.set_border` | `tables set-border` | Set border properties on a table or cell range. |
| `doc.tables.clear_border` | `tables clear-border` | Remove border formatting from a table or cell range. |
| `doc.tables.apply_border_preset` | `tables apply-border-preset` | Apply a border preset (e.g. all borders, outside only) to a table. |
| `doc.tables.set_shading` | `tables set-shading` | Set the background shading color on a table or cell range. |
| `doc.tables.clear_shading` | `tables clear-shading` | Remove shading from a table or cell range. |
| `doc.tables.set_table_padding` | `tables set-table-padding` | Set default cell padding for the entire table. |
| `doc.tables.set_cell_padding` | `tables set-cell-padding` | Set padding on a specific table cell or cell range. |
| `doc.tables.set_cell_spacing` | `tables set-cell-spacing` | Set the cell spacing for the target table. |
| `doc.tables.clear_cell_spacing` | `tables clear-cell-spacing` | Remove custom cell spacing from the target table. |
| `doc.tables.get` | `tables get` | Retrieve table structure and dimensions by locator. |
| `doc.tables.get_cells` | `tables get-cells` | Retrieve cell information for a table, optionally filtered by row or column. |
| `doc.tables.get_properties` | `tables get-properties` | Retrieve layout and style properties of a table. |
| `doc.tables.get_styles` | `tables get-styles` | List all table styles and the document-level default table style setting. |
| `doc.tables.set_default_style` | `tables set-default-style` | Set the document-level default table style (w:defaultTableStyle in settings.xml). |
| `doc.tables.clear_default_style` | `tables clear-default-style` | Remove the document-level default table style setting. |
#### Table of contents
| Operation | CLI command | Description |
| ---------------------- | ------------------ | -------------------------------------------------------------------- |
| `doc.toc.list` | `toc list` | List all tables of contents in the document. |
| `doc.toc.get` | `toc get` | Retrieve details of a specific table of contents. |
| `doc.toc.configure` | `toc configure` | Update the configuration switches of a table of contents. |
| `doc.toc.update` | `toc update` | Rebuild or refresh the materialized content of a table of contents. |
| `doc.toc.remove` | `toc remove` | Remove a table of contents from the document. |
| `doc.toc.mark_entry` | `toc mark-entry` | Insert a TC (table of contents entry) field at the target paragraph. |
| `doc.toc.unmark_entry` | `toc unmark-entry` | Remove a TC (table of contents entry) field from the document. |
| `doc.toc.list_entries` | `toc list-entries` | List all TC (table of contents entry) fields in the document body. |
| `doc.toc.get_entry` | `toc get-entry` | Retrieve details of a specific TC (table of contents entry) field. |
| `doc.toc.edit_entry` | `toc edit-entry` | Update the properties of a TC (table of contents entry) field. |
#### Images
| Operation | CLI command | Description |
| ---------------------------------- | ------------------------------ | ----------------------------------------------------------------- |
| `doc.images.list` | `images list` | List all images in the document. |
| `doc.images.get` | `images get` | Get details for a specific image by its stable ID. |
| `doc.images.delete` | `images delete` | Delete an image from the document. |
| `doc.images.move` | `images move` | Move an image to a new location in the document. |
| `doc.images.convert_to_inline` | `images convert-to-inline` | Convert a floating image to inline placement. |
| `doc.images.convert_to_floating` | `images convert-to-floating` | Convert an inline image to floating placement. |
| `doc.images.set_size` | `images set-size` | Set explicit width/height for an image. |
| `doc.images.set_wrap_type` | `images set-wrap-type` | Set the text wrapping type for a floating image. |
| `doc.images.set_wrap_side` | `images set-wrap-side` | Set which side(s) text wraps around a floating image. |
| `doc.images.set_wrap_distances` | `images set-wrap-distances` | Set the text-wrap distance margins for a floating image. |
| `doc.images.set_position` | `images set-position` | Set the anchor position for a floating image. |
| `doc.images.set_anchor_options` | `images set-anchor-options` | Set anchor behavior options for a floating image. |
| `doc.images.set_z_order` | `images set-z-order` | Set the z-order (relativeHeight) for a floating image. |
| `doc.images.scale` | `images scale` | Scale an image by a uniform factor applied to both dimensions. |
| `doc.images.set_lock_aspect_ratio` | `images set-lock-aspect-ratio` | Lock or unlock the aspect ratio for an image. |
| `doc.images.rotate` | `images rotate` | Set the absolute rotation angle for an image. |
| `doc.images.flip` | `images flip` | Set horizontal and/or vertical flip state for an image. |
| `doc.images.crop` | `images crop` | Apply rectangular edge-percentage crop to an image. |
| `doc.images.reset_crop` | `images reset-crop` | Remove all cropping from an image. |
| `doc.images.replace_source` | `images replace-source` | Replace the image source while preserving identity and placement. |
| `doc.images.set_alt_text` | `images set-alt-text` | Set the accessibility description (alt text) for an image. |
| `doc.images.set_decorative` | `images set-decorative` | Mark or unmark an image as decorative. |
| `doc.images.set_name` | `images set-name` | Set the object name for an image. |
| `doc.images.set_hyperlink` | `images set-hyperlink` | Set or remove the hyperlink attached to an image. |
| `doc.images.insert_caption` | `images insert-caption` | Insert a caption paragraph below the image. |
| `doc.images.update_caption` | `images update-caption` | Update the text of an existing caption paragraph. |
| `doc.images.remove_caption` | `images remove-caption` | Remove the caption paragraph from below the image. |
#### Comments
| Operation | CLI command | Description |
| --------------------- | ----------------- | -------------------------------------------------------------------------- |
| `doc.comments.create` | `comments create` | Create a new comment thread (or reply when parentCommentId is given). |
| `doc.comments.patch` | `comments patch` | Patch fields on an existing comment (text, target, status, or isInternal). |
| `doc.comments.delete` | `comments delete` | Remove a comment or reply by ID. |
| `doc.comments.get` | `comments get` | Retrieve a single comment thread by ID. |
| `doc.comments.list` | `comments list` | List all comment threads in the document. |
#### Track changes
| Operation | CLI command | Description |
| -------------------------- | ---------------------- | -------------------------------------------------------- |
| `doc.track_changes.list` | `track-changes list` | List all tracked changes in the document. |
| `doc.track_changes.get` | `track-changes get` | Retrieve a single tracked change by ID. |
| `doc.track_changes.decide` | `track-changes decide` | Accept or reject a tracked change (by ID or scope: all). |
#### History
| Operation | CLI command | Description |
| ------------------ | -------------- | ---------------------------------------------------------------- |
| `doc.history.get` | `history get` | Query the current undo/redo history state of the active editor. |
| `doc.history.undo` | `history undo` | Undo the most recent history-safe mutation in the active editor. |
| `doc.history.redo` | `history redo` | Redo the most recently undone action in the active editor. |
#### Session
| Operation | CLI command | Description |
| ------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `doc.open` | `open` | Open a document and create a persistent editing session. Optionally override the document body with contentOverride + overrideType (markdown, html, or text). |
| `doc.save` | `save` | Save the current session to the original file or a new path. |
| `doc.close` | `close` | Close the active editing session and clean up resources. |
| `doc.status` | `status` | Show the current session status and document metadata. |
| `doc.describe` | `describe` | List all available CLI operations and contract metadata. |
| `doc.describe_command` | `describe command` | Show detailed metadata for a single CLI operation. |
| `doc.session.list` | `session list` | List all active editing sessions. |
| `doc.session.save` | `session save` | Persist the current session state. |
| `doc.session.close` | `session close` | Close a specific editing session by ID. |
| `doc.session.set_default` | `session set-default` | Set the default session for subsequent commands. |
## Related
* [Document API](/document-api/overview) — the in-browser API that defines the operation set
* [CLI](/document-engine/cli) — use the same operations from the terminal
* [Collaboration guides](/modules/collaboration/overview) — set up Liveblocks, Hocuspocus, or SuperDoc Yjs