@promptscript/cli 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0](https://github.com/mrwogu/promptscript/compare/v1.0.0...v1.1.0) (2026-03-11)
+
+
+### Features
+
+* add Factory AI, OpenCode, and Gemini CLI compilation targets ([9c206af](https://github.com/mrwogu/promptscript/commit/9c206af40fe35412b948b1a32d9fec8b309e3c91))
+* add root SKILL.md as canonical source with sync pipeline ([#75](https://github.com/mrwogu/promptscript/issues/75)) ([cc76023](https://github.com/mrwogu/promptscript/commit/cc76023eaea92318303081dcd439ae3185b1bbe0))
+* **cli:** enterprise registry redesign ([#74](https://github.com/mrwogu/promptscript/issues/74)) ([a1ce2ca](https://github.com/mrwogu/promptscript/commit/a1ce2cad2a80d902e380907dd5b1c474952f8b6f))
+* new formatters ([#78](https://github.com/mrwogu/promptscript/issues/78)) ([b30585a](https://github.com/mrwogu/promptscript/commit/b30585ae483a3c02b690ab8755ccd44f9cf355a7))
+
+
+### Bug Fixes
+
+* **cli:** include skills in build assets and update CI smoke tests ([62d8d0b](https://github.com/mrwogu/promptscript/commit/62d8d0bbc86f02ad11424110fb7bf2215dd80299))
+
 ## [1.0.0](https://github.com/mrwogu/promptscript/compare/v1.0.0-rc.3...v1.0.0) (2026-03-06)
 
 

package/README.md

@@ -15,7 +15,7 @@ Write AI instructions once in PromptScript, compile to GitHub Copilot, Claude Co
 Every AI coding tool uses a different config format. As your organization grows, so does the chaos:
 
 ```
-50 repos x 4 AI tools = 200 files to maintain
+50 repos x 37 AI agents = 1850 files to maintain
 
 repo-1/CLAUDE.md          repo-1/.cursorrules      repo-1/.github/copilot-instructions.md
 repo-2/CLAUDE.md          repo-2/.cursorrules      repo-2/.github/copilot-instructions.md
@@ -120,12 +120,15 @@ Run `prs compile` and get correctly formatted output for every AI tool your team
 
 ## Supported Targets
 
-| AI Tool                | Output                                             |
-| :--------------------- | :------------------------------------------------- |
-| **GitHub Copilot**     | `.github/copilot-instructions.md`, agents, prompts |
-| **Claude Code**        | `CLAUDE.md`, skills, local memory                  |
-| **Cursor**             | `.cursor/rules/*.mdc`                              |
-| **Google Antigravity** | `.agent/rules/*.md`                                |
+| AI Tool                | Output                                                |
+| :--------------------- | :---------------------------------------------------- |
+| **GitHub Copilot**     | `.github/copilot-instructions.md`, agents, prompts    |
+| **Claude Code**        | `CLAUDE.md`, skills, local memory                     |
+| **Cursor**             | `.cursor/rules/*.mdc`                                 |
+| **Google Antigravity** | `.agent/rules/*.md`                                   |
+| **Factory AI**         | `AGENTS.md`, `.factory/skills/`, `.factory/commands/` |
+| **OpenCode**           | `agents.yaml`                                         |
+| **Gemini CLI**         | `GEMINI.md`                                           |
 
 ## Configuration
 
@@ -141,10 +144,122 @@ targets:
   - github
   - claude
   - cursor
+  - factory
+  - opencode
+  - gemini
 ```
 
 See the [full configuration reference](https://getpromptscript.dev/reference/config/) for registry auth, watch settings, validation rules, and more.
 
+## Detailed Command Usage
+
+### Init
+
+```bash
+prs init [options]
+
+Options:
+  -n, --name <name>        Project name (auto-detected)
+  -t, --team <team>        Team namespace
+  --inherit <path>         Inheritance path (e.g., @company/team)
+  --registry <path>        Registry path
+  --targets <targets...>   Target AI tools (github, claude, cursor, opencode, gemini, ...)
+  -i, --interactive        Force interactive mode
+  -y, --yes                Skip prompts, use defaults
+  -f, --force              Force reinitialize even if already initialized
+```
+
+**Auto-detection:** Project name, languages, frameworks, and existing AI tool configurations.
+
+Creates:
+
+- `promptscript.yaml` - Configuration file
+- `.promptscript/project.prs` - Main project file
+
+### Compile
+
+```bash
+prs compile [options]
+
+Options:
+  -t, --target <target>   Specific target (github, claude, cursor, opencode, gemini, ...)
+  -a, --all               All configured targets (default)
+  -w, --watch             Watch mode for continuous compilation (uses chokidar)
+  -o, --output <dir>      Output directory
+  --dry-run               Preview changes without writing files
+  --force                 Force overwrite existing files without prompts
+  --registry <path>       Path or URL to registry
+  --verbose               Show detailed compilation progress
+  --debug                 Show debug information (includes verbose)
+```
+
+**Watch Mode:** Uses [chokidar](https://github.com/paulmillr/chokidar) for reliable file watching across all platforms. Automatically recompiles when `.prs` files change.
+
+**Overwrite Protection:** By default, `prs compile` protects user-created files from accidental overwriting. Files generated by PromptScript contain a marker (`> Auto-generated by PromptScript`) and are overwritten silently. For files without this marker:
+
+- **Interactive mode:** You'll be prompted to overwrite (y/N/a)
+- **Non-interactive mode:** Compilation fails with a list of conflicting files
+
+Use `--force` to skip all prompts and overwrite everything. Use `--dry-run` to preview conflicts before writing.
+
+### Validate
+
+```bash
+prs validate [options]
+
+Options:
+  --strict                Treat warnings as errors
+  --format <format>       Output format (text, json)
+```
+
+### Pull Updates
+
+```bash
+prs pull [options]
+
+Options:
+  -f, --force             Force overwrite local files
+```
+
+### Show Diff
+
+```bash
+prs diff [options]
+
+Options:
+  -t, --target <target>   Specific target to diff
+  --full                  Show full diff without truncation
+  --no-pager              Disable pager output
+```
+
+By default, diff output is shown through a pager (`less`) for easy scrolling. Use `--no-pager` to disable this behavior. You can customize the pager via the `PAGER` environment variable.
+
+### Check for Updates
+
+```bash
+prs update-check
+```
+
+Checks if a newer version of the CLI is available on npm and displays the result:
+
+```
+@promptscript/cli v1.0.0
+✓ Up to date
+```
+
+Or if an update is available:
+
+```
+@promptscript/cli v1.0.0
+Update available: 1.0.0 → 1.1.0 (npm i -g @promptscript/cli)
+```
+
+**Automatic Update Checks:** The CLI automatically checks for updates once every 24 hours when running any command. The check is non-blocking and cached locally. To disable automatic checks, set the `PROMPTSCRIPT_NO_UPDATE_CHECK` environment variable:
+
+```bash
+PROMPTSCRIPT_NO_UPDATE_CHECK=1 prs compile
+```
+
 ## Environment Variables
 
 | Variable                       | Description                                    |