Commands
mkdir
Create a new folder in Poly.
poly mkdir creates a folder in Poly. Give it a parent and a name, or a single full path — both forms work.
Usage
poly mkdir <PARENT> [NAME]
If NAME is omitted, PARENT is treated as the full path of the folder to create, and its last segment becomes the folder name.
Flags
| Flag | Description |
|---|---|
--notes <TEXT> | Attach notes to the new folder. |
--tag <TAG> | Add a tag. Repeatable. Color-prefixed tags (e.g. red:school) sync as colored Finder tags on macOS. |
--folder-color <COLOR> | Set the folder's color. |
--folder-sticker <STICKER> | Set the folder's sticker. |
--folder-emoji <EMOJI> | Set the folder's emoji. |
Examples
# Create a folder in your home drive
poly mkdir //Home projects
# Create using a single full path instead
poly mkdir //Home/projects/2026
# Create with tags and notes
poly mkdir //Home invoices --tag red:finance --notes "Q1 invoices"
# Create with a folder color and emoji
poly mkdir //Home archive-photos --folder-color blue --folder-emoji 📸
# Create inside a shared drive
poly mkdir //shared/design-team assets
Related
mv— move a folder after creating it.ls— list a folder's contents.rm— delete a folder.- How it Works — file reference syntax and the local cache.