Introduction

prompts-gpt is a CLI and Node.js SDK for syncing AI prompt packs, running multi-iteration sweeps, and orchestrating multi-agent workflows across every major AI coding agent — Codex, Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, Continue, Junie, and Amp.

What is prompts-gpt?

prompts-gpt solves three problems that every team using AI coding agents runs into:

Prompt management — Store, version, and distribute reusable prompt packs across your team. Sync them as agent-native files (Cursor rules, AGENTS.md, copilot-instructions, etc.) so every agent in your stack gets the same instructions.

Execution orchestration — Run prompts through local AI agents with configurable providers, models, timeouts, and retry logic. Choose from single-shot runs, sequential batches, multi-iteration sweeps, or multi-agent orchestration.

Quality automation — Use sweep iterations with context chaining and self-evaluation scoring to build autonomous audit and refinement pipelines that progressively improve codebases.

Key Features

Prompt Sync Engine

Pull prompt packs from the prompts-gpt.com library or generate them from goals
Sync to 11 agent targets simultaneously (Codex, Cursor, Claude Code, etc.)
Managed blocks in AGENTS.md, CLAUDE.md, GEMINI.md — safe to re-run without overwriting manual edits

Execution Runtime

run — Execute a single prompt with any provider
run-batch — Run multiple prompts sequentially
sweep — Multi-iteration engine with context chaining and self-evaluation
orchestrate — Multi-agent modes: parallel racing, pipeline chaining, eval scoring

Provider Support

Provider	CLI Binary	Default Model
Codex (OpenAI)	`codex`	gpt-5.4-mini
Claude Code	`claude`	claude-sonnet-4-20250514
Cursor	`cursor`	auto
GitHub Copilot	`copilot`	auto

Agent Integrations

Agent	Generated Files
Codex	`AGENTS.md` (managed block)
Claude Code	`CLAUDE.md` (managed block)
Cursor	`.cursor/rules/.mdc` + `.cursor/commands/``.md`
VS Code	`.github/copilot-instructions.md` + `.vscode/prompts-gpt.code-snippets`
GitHub Copilot	`.github/prompts/*.prompt.md`
Continue	`.continue/rules/*.md`
Gemini CLI	`GEMINI.md` (managed block)
Windsurf	`.windsurf/rules/*.md`
Cline	`.clinerules/*.md`
Junie	`.junie/guidelines.md` (managed block)
Amp	`AGENT.md` (managed block)

Architecture Overview

prompts-gpt.com (cloud)          Local Project
┌─────────────────────┐          ┌──────────────────────────┐
│  Prompt Library      │──pull──▶│  .prompts-gpt/           │
│  Project Config      │         │    manifest.json          │
│  Model Registry      │         │    *.md (prompt packs)    │
│  AI Generator        │         │    sweeps/*.md            │
└─────────────────────┘          │    config.json            │
                                 │    .credentials.json      │
                                 └──────────┬───────────────┘
                                            │ sync
                    ┌───────────────────────┼───────────────────────┐
                    ▼                       ▼                       ▼
              AGENTS.md              .cursor/rules/         .github/prompts/
              CLAUDE.md              .cursor/commands/       copilot-instructions.md
              GEMINI.md              .windsurf/rules/        .continue/rules/
              AGENT.md               .clinerules/            .junie/guidelines.md

Requirements

Node.js ≥ 18.18
At least one AI agent CLI installed (Codex, Claude, Cursor, or Copilot)
A project token from prompts-gpt.com (for cloud features — optional for local-only workflows)

Next Steps

Installation — Install the package
Quick Start — Get running in 5 minutes
Authentication — Set up your project token