Skip to main content
The CLI writes into the current folder unless you pass --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 from main and replaces the file. Your own edits to that file are overwritten, so commit them first or keep them under a different name.