prompts-gpt sync

Pull prompt packs from your prompts-gpt.com library and sync agent files for all configured targets.

Usage

prompts-gpt sync [--goal <text>] [--agent <targets>] [--out <dir>] [--overwrite] [--dry-run]

What It Does

Pulls prompt packs from the prompts-gpt.com project library
Writes Markdown files to .prompts-gpt/
Generates agent-specific files for each target (AGENTS.md, .cursor/rules/, etc.)
Updates the local manifest (manifest.json)

Options

Flag	Description
`--goal <text>`	Generate a prompt pack before syncing
`--generated-only`	Skip library pull; sync only the generated prompt from `--goal`
`--query <text>`	Search filter for pulled packs
`--q <text>`	Alias for `--query`
`--category <name>`	Filter by category
`--tool <name>`	Filter by supported tool
`--output-type <name>`	Filter by output type
`--limit <n>`	Max prompts to pull (1–100)
`--context <text>`	Extra context for generated packs
`--constraints <text>`	Constraints for generated packs
`--desired-output <text>`	Preferred output shape
`--mode <name>`	Generation mode. Default: `implement`
`--artifact-type <name>`	Artifact type. Default: `prompt-file`
`--web-search`	Allow server-side web research for generation
`--agent <targets>`	Comma-separated agent targets. Default: `all`
`--out <dir>`	Output directory. Default: `.prompts-gpt`
`--overwrite`	Replace existing files
`--dry-run`	Preview without writing
`--token <token>`	Override stored token
`--token-stdin`	Read token from stdin
`--api-url <url>`	Override API URL
`--cwd <path>`	Project directory

Examples

# Pull all prompts and sync all agent files
prompts-gpt sync

# Generate + pull + sync
prompts-gpt sync --goal "Add error handling to API routes"

# Sync only for specific agents
prompts-gpt sync --agent cursor,codex

# Preview without writing
prompts-gpt sync --dry-run

# Only sync the generated prompt
prompts-gpt sync --goal "Fix security bugs" --generated-only

Data Privacy

Prompts are downloaded from your prompts-gpt.com library
When --goal is used, the text is sent for AI generation
No local files or repo content are uploaded
Use --dry-run to preview before committing

Generated Files

Depending on the --agent targets, sync creates:

Agent Target	Files Created
codex	`AGENTS.md` (managed block)
claude-code	`CLAUDE.md` (managed block)
cursor	`.cursor/rules/prompts-gpt-.mdc`, `.cursor/commands/prompts-gpt-``.md`
vscode	`.github/copilot-instructions.md`, `.github/instructions/prompts-gpt.instructions.md`, `.vscode/prompts-gpt.code-snippets`
copilot	`.github/prompts/prompts-gpt-*.prompt.md`
continue	`.continue/rules/prompts-gpt-*.md`
gemini-cli	`GEMINI.md` (managed block)
windsurf	`.windsurf/rules/prompts-gpt-*.md`
cline	`.clinerules/prompts-gpt-*.md`
junie	`.junie/guidelines.md` (managed block)
amp	`AGENT.md` (managed block)

Managed Blocks

Files with "managed block" use  /  markers. Re-running sync updates only the managed section — your manual content outside the block is preserved.