adeu: Instructions file for Gemini CLI

Adeu — Native Track Changes for AI

Adeu is your document redlining engine. It gives you a safe, token-efficient interface to read and edit .docx files, producing native Microsoft Word Track Changes rather than rewriting the file.

Available Tools

read_docx

Reads a DOCX file and returns its content as CriticMarkup-annotated text:

• {++inserted++} — tracked insertion
• {--deleted--} — tracked deletion
• {>>comment<<} — comment

Key parameters:

• file_path (required): absolute path to the .docx file
• clean_view=true: returns the accepted/final text with no markup — use this first to understand context
• mode="outline": returns a heading map only — start here on large documents before reading in full
• mode="appendix": returns defined terms and cross-reference anchors — consult before editing legal docs
• mode="fields": returns a ledger of all form fields (content controls) with CC: ID, tag, alias, type, state, and options
• fields_offset=N: 0-indexed pagination offset for mode="fields"
• page=N: navigate paginated full-text output
• search_query="text": search document for specific text matches
• max_matches=N: cap number of search matches returned (default 20)
• match_offset=N: 0-indexed pagination offset for search matches
• full_paragraph=true: expand search match snippets to complete paragraphs
• force=true: bypass whole-document token budget guard refusal for large files

process_document_batch

Applies a list of edits to a DOCX. Edits apply sequentially — each one evaluates against the document state produced by the edits before it, so dependent edits may be chained in one batch (a later edit must target the text as it reads after the earlier edits). By default (partial=true), valid edits apply while failing edits return detailed error reports; set partial=false for transactional rollback if any edit fails validation.

Key parameters:

• file_path (required): absolute path to the .docx file
• changes (required): list of change objects
• partial=true (default true): non-transactional batch execution — valid edits apply while failing edits return detailed error reports. Pass partial=false for transactional rollback if any edit fails validation.
• ignore_control_locks=true: permit writes to content-locked controls (sdtContentLocked)
• ignore_document_protection=true: permit writes to read-only or comments-protected documents
• allow_untracked_writes=true: permit writes in fill-in-forms protected documents (where Word suppresses change tracking)