Docs/CLI/Global Config

Global Config

GwenUI CLI stores your preferences in a global config file at ~/.gwen/config.json.

Location #

~/.gwen/config.json

The global config persists your preferences across all GwenUI projects on your machine.

{
  "blocksDir": "src/components/blocks",
  "cssFile": "src/app/globals.css",
  "theme": "gwen-noir",
  "packageManager": "pnpm"
}

Field	Type	Default	Description
`blocksDir`	`string`	`src/components/blocks`	Where blocks are installed
`cssFile`	`string`	`src/app/globals.css`	Your global CSS file path
`theme`	`string`	`gwen-noir`	Active GwenUI theme
`packageManager`	`string`	auto-detected	Package manager to use

The config is plain JSON — edit it directly:

# Open in your default editor
code ~/.gwen/config.json
 
# Or cat to inspect
cat ~/.gwen/config.json

Editing the global config affects all GwenUI projects on your machine. Per-project overrides are not yet supported — coming in a future release.

Delete the config file to reset to defaults:

rm ~/.gwen/config.json

Then run gwen-ui init again to reconfigure.

If packageManager is not set, the CLI auto-detects based on lockfiles: