flawless-ui-ux 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 
 ## Unreleased
 
+## 0.3.0
+
+### Changed
+
+- Made CLI install project-local by default. A bare install copies the skill for both agents into the current project; user-wide installation now requires explicit --global.
+- Retained --project <directory> for another project, mutually exclusive with --global. Existing local and global installations are preserved.
+- Updated help, README setup, contract, and package-level tests for the new default. The legacy Bash alternative retains its own explicit --project option.
+
 ## 0.2.0
 
 ### Added

package/README.md

@@ -8,7 +8,7 @@ flawless-ui-ux helps coding agents create, redesign, and refine web interfaces w
 
 ## Setup
 
-Choose your package manager to install the skill for **Codex and OpenCode globally**. The CLI requires **Node 22.12+**; no checkout or Bash is needed.
+From your project directory, choose your package manager to install the skill for **Codex and OpenCode in that project**. The CLI requires **Node 22.12+**; no checkout or Bash is needed.
 
 ```bash
 npx flawless-ui-ux@latest install
@@ -20,14 +20,14 @@ Run one of these commands. The examples below use `npx`; replace it with `pnpm d
 
 ### Choose an agent and scope
 
-For a specific agent, or a project-local installation:
+For a specific agent, or an installation across projects:
 
 ```bash
 npx flawless-ui-ux install --codex
-npx flawless-ui-ux install --opencode --project .
+npx flawless-ui-ux install --opencode --global
 ```
 
-The default is both agents globally. Use `--codex`, `--opencode`, or `--all-agents` to select targets. `--project <directory>` installs only in that project; `--global` makes the default scope explicit. Start a new agent session if needed for discovery.
+The default is both agents in the current project. Use `--codex`, `--opencode`, or `--all-agents` to select targets. `--global` explicitly installs in your user profile; `--project <directory>` selects another project. Start a new agent session if needed for discovery.
 
 Existing installations are never overwritten, including links and local changes. All selected destinations are checked before copying. Review or remove an existing installation yourself before reinstalling. Global paths honor `CODEX_HOME` and `XDG_CONFIG_HOME`; project paths are `.agents/skills/flawless-ui-ux` for Codex and `.opencode/skills/flawless-ui-ux` for OpenCode.
 
@@ -35,11 +35,11 @@ Existing installations are never overwritten, including links and local changes.
 <summary>Alternative: install from a checkout with Bash</summary>
 
 ```bash
-bash ./install.sh --codex
-bash ./install.sh --opencode
+bash ./install.sh --codex --project
+bash ./install.sh --opencode --project
 ```
 
-Use `--all-agents` for both. For project-local installation, run `bash /path/to/flawless-ui-ux/install.sh --all-agents --project` from the target project's directory. On Windows, the Bash alternative requires Git Bash or WSL.
+Run these from the target project's directory, using the script's absolute path when the checkout is elsewhere. Use `--all-agents` for both. The legacy Bash script requires `--project` for local installation and otherwise installs globally. On Windows, this alternative requires Git Bash or WSL.
 
 </details>
 

package/bin/flawless-ui-ux.js

@@ -19,7 +19,8 @@ try {
           [--timeout MS] [--browser-executable FILE] [--format text|json]
   verify RUN_JSON [--output NEW_DIR] [--browser-executable FILE] [--format text|json]
 
-install defaults to both agents globally. Existing installations are preserved.
+install defaults to both agents in the current project. Use --global for user-wide installation.
+Existing installations are preserved.
 inspect requires a source or URL. Defaults: 1440x900 and 390x844, 15000 ms.
 Inspection does not start servers, download browsers, edit sources, or submit forms.
 FLAWLESS_BROWSER_EXECUTABLE explicitly selects an installed Chromium executable.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flawless-ui-ux",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A UI/UX skill and local inspection CLI for coding agents to build and refine product-specific interfaces.",
   "type": "module",
   "license": "MIT",

package/src/install.js

@@ -58,7 +58,7 @@ async function rollback(created) {
 export async function install(options, runtime = {}) {
   const env = runtime.env || process.env;
   const home = runtime.home || os.homedir();
-  const project = options.project ? await projectRoot(options.project) : null;
+  const project = options.global ? null : await projectRoot(options.project || '.');
   const agent = options.agent || 'all';
   if (!['all', 'codex', 'opencode'].includes(agent)) throw new Error('Unknown installation agent.');
   if (!(await fs.stat(path.join(bundledSkill, 'SKILL.md'))).isFile()) throw new Error('The package does not contain an installable skill.');

package/src/options.js

@@ -42,7 +42,7 @@ export function parse(argv) {
       continue;
     }
     seen.add(name);
-    if (operation === 'install' && name === 'global') continue;
+    if (operation === 'install' && name === 'global') { options.global = true; continue; }
     const value = argv.shift();
     if (!value || value.startsWith('--')) throw new Error(`Missing value for ${flag}`);
     if (name === 'source') options.sources.push(value);