reading-documentslisted

# Reading Documents Two CLIs ship with this plugin under `${CLAUDE_PLUGIN_ROOT}/bin/`. They are also symlinked onto `PATH` as `readoc` and `readir`, so you can usually call them by bare name. The standard `Read` tool cannot parse `.docx`/`.xlsx`/`.pdf`. Use these instead. **Neither tool truncates content** — spreadsheet cells, pages, and tables are emitted in full. ## `readoc` — read specific files ```bash readoc file.docx # read a Word document readoc file.xlsx # read an Excel spreadsheet readoc file.pdf # read a PDF readoc file1.docx file2.xlsx # read several; each gets a header box ``` Each file is preceded by an unambiguous header box (`path (Type, size)`), so concatenated output is never confusing. Headings, tables, and sheets are preserved; long cells overflow their column rather than being cut. ## `readir` — explore / read / search a folder ```bash # Tree — explore structure readir tree path/to/folder # file tree with sizes readir tree path/to/folder --summary # + extension/size summary readir tree path/to/folder --max-depth 2 # limit recursion depth readir tree path/to/folder --filter docx,pdf # only certain extensions # Read — concatenate all readable files (same header-box convention as readoc) readir read path/to/folder readir read path/to/folder --filter md,docx # only specific types readir read path/to/folder --exclude pdf # skip certain types readir read path/to