DSL Cheatsheet - Attachments Library

This page provides a comprehensive list of all available DSL (Domain-Specific Language) commands in the attachments library. This list is generated automatically from the library’s source code, so it is always up-to-date.

The cheatsheet includes:

Command names and brief descriptions
Data types expected for each command (string, int, boolean, etc.)
Default values used when the command is not specified
Allowable values for commands with restricted options
Context information showing where each command is used

Command	Type	Default	Allowable Values	Used In
`characters`	`int`	`1000`	—	`splitter.characters`
`columns`	`int`	`10`	—	`splitter.columns`
`custom` separator.	`string`	`---`	`separator`	`splitter.custom`
`dirs_only_with_files`	`string`	`true`	`true`, `false`	`loader.directory_to_structure`
`files` false	—	—	`true`, `false`	`loader.directory_to_structure` `loader.git_repo_to_structure`
`force`	`string`	`false`	`true`, `false`	`loader.directory_to_structure` `loader.git_repo_to_structure`
`format` commands.	`string`	`markdown`	`plain`, `text`, `txt`, ... (10 total)	`_get_smart_text_presenter` `loader.directory_to_structure` `loader.git_repo_to_structure` `processor.csv_to_llm` `processor.docx_to_llm` `processor.eps_to_llm` `processor.excel_to_llm` `processor.pdf_to_llm` `processor.pptx_to_llm` `processor.svg_to_llm` `processor.webpage_to_llm`
`fullpage`	`string`	`true`	`true`, `false`	`presenter.images`
`glob` pattern structure and file list. ...	`string`	—	—	`loader.directory_to_structure` `loader.git_repo_to_structure`
`head` true	`string`	`false`	`true`, `false`	`processor.csv_to_llm`
`ignore`	`string`	`standard`	—	`loader.directory_to_structure` `loader.git_repo_to_structure`
`images` true	`string`	`true`	`true`, `false`	`processor.docx_to_llm` `processor.excel_to_llm` `processor.pdf_to_llm` `processor.pptx_to_llm` `processor.webpage_to_llm`
`lang` uage for OCR using the `lang` command	`string`	`eng`	`ara]``	`presenter.ocr`
`limit` pandas DataFrame rows.	—	—	—	`modifier.limit`
`lines`	`int`	`50`	—	`splitter.lines`
`max_files`	`int`	`1000`	—	`loader.directory_to_structure` `loader.git_repo_to_structure`
`mode`	—	—	—	`loader.directory_to_structure` `loader.git_repo_to_structure`
`ocr` auto	`string`	`auto`	`auto`, `true`, `false`	`processor.pdf_to_llm`
`prompt`	`string`	—	—	`adapter.agno` `adapter.claude` `adapter.to_clipboard_text`
`recursive`	`string`	`true`	`true`, `false`	`loader.directory_to_structure`
`resize`	—	—	—	`presenter.images` `presenter.images` `presenter.images`
`resize_images`	—	—	—	`presenter.images` `presenter.images` `presenter.images` `presenter.images` `presenter.images` `presenter.images` `refiner.resize_images`
`rotate`	—	—	`degrees`	`modifier.rotate`
`rows`	`int`	`100`	—	`splitter.rows`
`select` columns from pandas DataFrame.	—	—	—	`modifier.select` `presenter.images` `processor.webpage_to_llm`
`split` paragraphs	—	—	`paragraphs`, `sentences`, `tokens`, ... (6 total)	`processor.webpage_to_llm`
`summary` true	`string`	`false`	`true`, `false`	`processor.csv_to_llm`
`tile` 2x2 grid	`string`	`2x2`	`2x2`	`refiner.tile_images`
`tokens`	`int`	`500`	—	`splitter.tokens`
`truncate` text content to specified character l...	`int`	`1000`	`text content`	`refiner.truncate`
`viewport`	`string`	`1280x720`	—	`presenter.images`
`wait`	`int`	`200`	—	`presenter.images`

Note

This cheatsheet is automatically regenerated whenever the documentation is built, both locally and in the GitHub Pages deployment. The DSL commands are discovered by analyzing the source code using AST parsing, ensuring the list is always current with the latest codebase.

Manual regeneration:

python scripts/generate_dsl_cheatsheet.py

Automatic regeneration:

✅ During local builds: myst build
✅ During GitHub Pages deployment (on push to main)

Extending and Contributing to Attachments

Developer Guide: Adding New DSL Commands

Examples & Tutorials

URL Morphing Tutorial