lynxprompt 2.1.39 → 2.1.41

package/README.md

@@ -70,6 +70,10 @@ lynxp wizard -f copilot       # .github/copilot-instructions.md
 # Generate multiple formats
 lynxp wizard -f agents,cursor,copilot
 
+# Next to AGENTS.md, CLAUDE.md and GEMINI.md just import it (@AGENTS.md);
+# --no-pointers writes full copies instead
+lynxp wizard -f agents,claude,gemini-cli
+
 # Non-interactive with all options
 lynxp wizard \
   --name "my-api" \
@@ -91,8 +95,13 @@ lynxp check
 
 # CI mode (exit code 0=pass, 1=fail)
 lynxp check --ci
+
+# The result as JSON: { valid, files, errors, warnings }
+lynxp check --json
 ```
 
+Besides empty files, placeholders and secrets, `check` fails on hidden Unicode: zero-width characters, bidi controls and tag characters that an agent reads as instructions but a reviewer cannot see. Each error names the line, column and code point. Emoji joiners, joiners inside Persian or Indic words and a byte order mark at the start of the file are not reported.
+
 ### Status (`lynxp status`)
 
 Show current AI configuration and tracked blueprints:
@@ -109,6 +118,9 @@ Download and track a blueprint from the marketplace:
 # Download and track
 lynxp pull bp_abc123
 
+# Several blueprints and hierarchies in one go
+lynxp pull bp_abc123 bp_def456 ha_xyz789
+
 # Push local file to cloud
 lynxp push
 
@@ -117,8 +129,15 @@ lynxp pull bp_abc123 --preview
 
 # Don't track for future syncs
 lynxp pull bp_abc123 --no-track
+
+# Fill [[VARIABLES]] as you download (others get their [[NAME|default]])
+lynxp pull bp_abc123 --vars PROJECT_NAME=acme,TEAM=Platform
 ```
 
+A file pulled with `--vars` stays tracked: `lynxp sync` refills cloud updates
+with the same values, and `lynxp push` refuses to send your values over the
+blueprint's variables unless you pass `--force`.
+
 ### Link / Unlink
 
 Connect local files to cloud blueprints:
@@ -146,6 +165,27 @@ lynxp diff bp_abc123
 lynxp diff --local
 ```
 
+### Sync
+
+Bring every tracked file and its cloud blueprint together in one step:
+
+```bash
+lynxp sync              # all tracked files
+lynxp sync AGENTS.md    # one file
+lynxp sync --dry-run    # show what would happen, change nothing
+```
+
+For each file, sync compares the local file and the cloud with the version
+you last pulled or pushed:
+
+- only the cloud changed: the file is updated from the cloud
+- only the file changed: your changes are pushed (marketplace blueprints are read-only, so they stay local)
+- both changed: the cloud version is written to `<file>.remote` and your file is left alone.
+  Merge what you need into the file, delete `<file>.remote`, and run `lynxp sync` again.
+  Until then sync and push leave that file alone.
+
+Sync exits with code 1 when a file has a conflict or could not be synced.
+
 ### Push (`lynxp push`)
 
 Upload a local configuration file to LynxPrompt cloud:
@@ -168,6 +208,22 @@ lynxp push AGENTS.md \
 lynxp push -y --name "My Config"
 ```
 
+### Agent Skills and MCP servers
+
+A skill's `SKILL.md` (in `.claude/skills/`, `.agents/skills/`, `.github/skills/`,
+`.cursor/skills/`, `.gemini/skills/` or `.opencode/skills/`) and an MCP config
+(`.mcp.json`, `.cursor/mcp.json`, `.vscode/mcp.json`, `.kiro/settings/mcp.json`)
+push and pull like any rules file, and keep their path.
+
+```bash
+lynxp push .claude/skills/release-notes/SKILL.md
+lynxp push .mcp.json
+
+# The same MCP servers in another tool's file
+lynxp convert .mcp.json vscode-mcp    # .vscode/mcp.json, "servers" key
+lynxp convert cursor-mcp              # from the first MCP config found
+```
+
 ### Search (`lynxp search`)
 
 Search public blueprints in the marketplace:
@@ -175,6 +231,7 @@ Search public blueprints in the marketplace:
 ```bash
 lynxp search "nextjs typescript"
 lynxp search react --limit 10
+lynxp search react --json
 ```
 
 ### List (`lynxp list`)
@@ -184,6 +241,7 @@ List your own blueprints:
 ```bash
 lynxp list
 lynxp list --visibility PUBLIC
+lynxp list --json
 ```
 
 ### Authentication
@@ -192,7 +250,7 @@ lynxp list --visibility PUBLIC
 # Login (opens browser for OAuth)
 lynxp login
 
-# Show current user
+# Show current user (--json for scripts)
 lynxp whoami
 
 # Logout