--directory <path>. It never deletes your files: JSON configuration is merged key by key, and Markdown components are written next to the ones you already have.
Where each type goes
Settings scope
Settings and hooks ask where to go. With--yes, or when there is no terminal to ask, they go to local.
Claude Code reads custom themes only from
~/.claude/themes/, so a setting that ships a theme writes it there whatever scope you pick.
Preview before writing
--dry-run lists every file the install would write and changes nothing.
Updating a component
Run the same install command again. The CLI downloads the current version frommain and replaces the file. Your own edits to that file are overwritten, so commit them first or keep them under a different name.