prompts-gpt 0.2.8

package/LICENSE

@@ -0,0 +1,75 @@
+Prompts-GPT Source Available License
+Version 1.0 — Effective 2026
+
+Copyright (c) 2026 Prompts-GPT. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person or organization
+("Licensee") obtaining a copy of this software and associated documentation
+files (the "Software"), to use the Software for personal and commercial
+purposes, subject to the following conditions:
+
+1. GRANT OF LICENSE
+
+   Licensee may:
+
+   a) Use the Software without restriction for personal projects,
+      commercial products, internal development, CI/CD pipelines,
+      and production deployments.
+
+   b) Install the Software in any number of environments.
+
+2. RESTRICTIONS
+
+   Licensee shall NOT:
+
+   a) Redistribute the Software, in whole or in part, as a standalone
+      package, download, or bundled component of another software
+      distribution system.
+
+   b) Modify, adapt, translate, reverse engineer, decompile, or
+      create derivative works of the Software's source code or
+      compiled artifacts.
+
+   c) Sublicense, rent, lease, sell, or otherwise transfer the
+      Software or rights to it to any third party.
+
+   d) Remove, alter, or obscure any proprietary notices, attribution
+      markers, or license text embedded in the Software.
+
+   e) Use the Software to build a competing prompt management
+      platform, agent orchestration service, or equivalent product.
+
+3. ATTRIBUTION
+
+   Build artifacts and runtime telemetry may contain account attribution
+   metadata. Tampering with or removing attribution data is prohibited.
+
+4. INTELLECTUAL PROPERTY
+
+   The Software is and remains the exclusive property of Prompts-GPT.
+   No title or ownership is transferred to Licensee.
+
+5. WARRANTY DISCLAIMER
+
+   THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+   OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
+   NONINFRINGEMENT.
+
+6. LIMITATION OF LIABILITY
+
+   IN NO EVENT SHALL PROMPTS-GPT BE LIABLE FOR ANY INDIRECT,
+   INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES ARISING
+   OUT OF THE USE OR INABILITY TO USE THE SOFTWARE.
+
+7. TERMINATION
+
+   This license terminates automatically if Licensee breaches any
+   term. Upon termination, Licensee must stop using the Software.
+
+8. GOVERNING LAW
+
+   This agreement is governed by the laws of the State of Delaware,
+   USA, without regard to conflict of laws principles.
+
+For licensing inquiries: licensing@prompts-gpt.com

package/README.md

@@ -0,0 +1,202 @@
+# prompts-gpt
+
+CLI and SDK for syncing [Prompts-GPT](https://prompts-gpt.com) prompt packs into any project — with integrations for **Codex**, **Claude Code**, **Cursor**, **VS Code**, **GitHub Copilot**, **Continue**, **Gemini CLI**, **Windsurf**, **Cline**, **Junie**, and **Amp**.
+
+---
+
+## Get Started
+
+```bash
+# Install
+npm install -D prompts-gpt
+
+# Interactive setup — handles credentials, config, and shows runnable commands
+npx prompts-gpt quickstart
+```
+
+On Windows PowerShell, prefer `npm exec` because it resolves the local workspace bin more reliably than `npx`:
+
+```powershell
+npm exec prompts-gpt -- quickstart
+npm exec prompts-gpt -- init
+npm exec prompts-gpt -- sweep
+```
+
+Or step by step:
+
+```bash
+npx prompts-gpt init                  # save your project token (prompts interactively)
+npx prompts-gpt sync                  # pull prompts and write agent files
+npx prompts-gpt list                  # see what's available
+npx prompts-gpt run                   # execute a single prompt
+npx prompts-gpt sweep                 # run a multi-iteration sweep
+```
+
+**Requires** Node.js 18.18+.
+
+---
+
+## What It Does
+
+Bridges the Prompts-GPT cloud library with the agent instruction files each tool reads:
+
+| Agent | Written files |
+|-------|--------------|
+| Codex | `AGENTS.md` |
+| Claude Code | `CLAUDE.md` |
+| Cursor | `.cursor/rules/*.mdc` + `.cursor/commands/*.md` |
+| VS Code | `.github/copilot-instructions.md` + `.vscode/*.code-snippets` |
+| Copilot | `.github/prompts/*.prompt.md` |
+| Continue | `.continue/rules/*.md` |
+| Gemini CLI | `GEMINI.md` |
+| Windsurf | `.windsurf/rules/*.md` |
+| Cline | `.clinerules/*.md` |
+| Junie | `.junie/guidelines.md` |
+| Amp | `AGENT.md` |
+
+---
+
+## Important Use Notes
+
+- `prompts-gpt` is the published npm package. If you see examples that reference internal app modules such as `lib/sdk`, those are app-internal examples, not the public package import path.
+- If Windows shows `Unknown command: quickstart` or `Unknown command: sweep` while `prompts-gpt` is installed, run `npm exec prompts-gpt -- help` or `node .\\node_modules\\prompts-gpt\\dist\\cli.js help` to confirm the local bin is being used instead of a stale shell shim.
+- Local orchestration can send prompt text, code context, and repository files to third-party model providers and agent CLIs. Review each provider's terms, privacy settings, and permitted automation paths before using private or regulated data.
+- Run artifacts are written locally and can include prompts, model output, logs, and worktree snapshots. Treat `.scripts/runs` as sensitive and do not commit or share it casually.
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `quickstart` | Interactive setup — credentials, config, and first run |
+| `init` | Save project token (prompts interactively if no flags given) |
+| `setup` | Scaffold local orchestration config |
+| `sync` | Pull + generate + write agent files |
+| `pull` | Download prompt packs as Markdown files |
+| `generate` | Generate a prompt pack from a goal |
+| `load-config` | Pull full config from Prompts Studio |
+| `run` | Execute one prompt with a local agent (`-f <file>`) |
+| `run-batch` | Execute multiple prompts |
+| `sweep` | Multi-iteration execution (`-f <file> -n <count>`) |
+| `list` | Show prompts, sweeps, agents |
+| `status` | Show workspace readiness |
+| `providers` | Show detected CLIs |
+| `doctor` | Validate prerequisites |
+| `validate` | Check config for errors |
+| `models` | List known models per provider |
+| `sync-models` | Fetch latest model registry from prompts-gpt.com |
+| `project` | Show the current project linked to the token |
+
+Run `prompts-gpt help <command>` for detailed options.
+
+---
+
+## Examples
+
+```bash
+# Run a single prompt (auto-selects if only one exists)
+prompts-gpt run -f .prompts-gpt/review.md --agent cursor
+
+# Run a sweep (auto-detects local sweeps, reads iterations from frontmatter)
+prompts-gpt sweep
+prompts-gpt sweep -f .prompts-gpt/sweeps/design.md -n 5
+
+# Preview what a sweep would do
+prompts-gpt sweep --dry-run
+
+# Run a sweep with reduced output
+prompts-gpt sweep --quiet
+
+# List available models for a provider
+prompts-gpt models --provider codex
+
+# Sync model registry from cloud
+prompts-gpt sync-models
+
+# Use model aliases for shorter commands
+prompts-gpt run --model opus     # resolves to claude-4.6-opus-high
+prompts-gpt run --model mini     # resolves to gpt-5.4-mini
+
+# Sync from cloud
+prompts-gpt sync --agent all
+
+# Generate a prompt pack from a goal
+prompts-gpt generate --goal "Review PRs for security issues" --sync-agents
+
+# CI/CD — pipe token from secret
+printf '%s' "$PROMPTS_GPT_TOKEN" | prompts-gpt sync --token-stdin --agent all
+```
+
+---
+
+## Configuration
+
+Create `.prompts-gpt/config.json` via `prompts-gpt setup`, or manually:
+
+```json
+{
+  "providerOrder": ["codex", "cursor", "claude", "copilot"],
+  "defaultAgent": "router",
+  "timeoutSeconds": 900,
+  "artifactsDir": ".scripts/runs"
+}
+```
+
+All options can be overridden via environment variables. See `prompts-gpt help setup`.
+
+---
+
+## SDK
+
+```typescript
+import { PromptsGptClient, syncPrompts } from "prompts-gpt";
+
+const client = new PromptsGptClient({
+  token: "pgpt_your_token",
+  apiUrl: "https://prompts-gpt.com",
+  fetch,
+});
+
+const prompts = await client.pullPrompts();
+await syncPrompts(prompts, { agent: "all" });
+
+// Fetch available models per provider
+const models = await client.fetchModels();
+// Filter by provider
+const codexModels = await client.fetchModels({ provider: "codex" });
+```
+
+---
+
+## Data Privacy
+
+**What stays local:**
+- `.prompts-gpt/*.md` prompt files are written locally
+- Agent files (`AGENTS.md`, `.cursor/rules/`, etc.) are updated locally
+- Run artifacts (`.scripts/runs/`) including logs, diffs, and summaries stay local
+- No local files, repo content, or uncommitted changes are uploaded
+
+**What is sent to prompts-gpt.com:**
+- `prompts-gpt generate --goal ...` — the text you explicitly pass via `--goal`, `--context`, and `--constraints` flags is sent to the API for AI-powered prompt generation
+- `prompts-gpt sync --goal ...` — same as above when `--goal` is used
+- `prompts-gpt pull` / `sync` / `load-config` — your project token is sent to authenticate and download prompts from your library
+
+**Do not include PII, secrets, or confidential data** in `--goal`, `--context`, or `--constraints` flags. Use `--dry-run` with `sync` to preview what would be sent.
+
+## Security
+
+- Credentials stored with `0600` permissions
+- Credentials added to `.gitignore`
+- Token prefix (`pgpt_`) validated before requests
+- HTTPS enforced for non-localhost
+- Path traversal blocked for all file writes
+- Secret patterns (`pgpt_`, `sk-`, `ghp_`) are redacted from API-bound input, command previews, and error output
+- SIGINT/SIGTERM cleanup releases locks
+- Run artifact directories are intended to stay local and may contain sensitive prompt, output, and diff data
+
+---
+
+## License
+
+[Prompts-GPT Source Available License](./LICENSE) — free for personal and commercial use. Redistribution and modification of the package are not permitted.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}