{"id":41547208,"url":"https://github.com/mrwogu/promptscript","last_synced_at":"2026-05-27T01:04:45.459Z","repository":{"id":333540163,"uuid":"1137511198","full_name":"mrwogu/promptscript","owner":"mrwogu","description":"Prompt-as-Code for Enterprise AI. Standardize, audit, and deploy instructions across any AI coding assistant.","archived":false,"fork":false,"pushed_at":"2026-05-21T23:15:24.000Z","size":174021,"stargazers_count":8,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T08:53:46.681Z","etag":null,"topics":["ai-tools","antigravity","claude","cli","cursor","developer-experience","devtools","enterprise","github-copilot","governance","llm","prompt-as-code","prompt-engineering","promptops","promptscript","typescript"],"latest_commit_sha":null,"homepage":"https://getpromptscript.dev/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrwogu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-19T13:15:50.000Z","updated_at":"2026-05-21T23:12:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"e9917577-f3e6-4130-9126-b15664878cfc","html_url":"https://github.com/mrwogu/promptscript","commit_stats":null,"previous_names":["mrwogu/promptscript"],"tags_count":43,"template":false,"template_full_name":null,"purl":"pkg:github/mrwogu/promptscript","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwogu%2Fpromptscript","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwogu%2Fpromptscript/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwogu%2Fpromptscript/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwogu%2Fpromptscript/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrwogu","download_url":"https://codeload.github.com/mrwogu/promptscript/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwogu%2Fpromptscript/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33545459,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"ssl_error","status_checked_at":"2026-05-26T15:22:15.568Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","antigravity","claude","cli","cursor","developer-experience","devtools","enterprise","github-copilot","governance","llm","prompt-as-code","prompt-engineering","promptops","promptscript","typescript"],"created_at":"2026-01-24T03:19:46.618Z","updated_at":"2026-05-27T01:04:45.451Z","avatar_url":"https://github.com/mrwogu.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/logo.svg\" alt=\"PromptScript Logo\" width=\"200\" /\u003e\n\n# PromptScript\n\n**One Source of Truth for All Your AI Coding Assistants**\n\n_Write once. Compile to 37 AI coding agents: GitHub Copilot, Claude Code, Cursor, and more._\n\n[![CI](https://github.com/mrwogu/promptscript/actions/workflows/ci.yml/badge.svg)](https://github.com/mrwogu/promptscript/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/github/mrwogu/promptscript/graph/badge.svg?token=MPUCPQLVWR)](https://codecov.io/github/mrwogu/promptscript)\n[![npm version](https://img.shields.io/npm/v/@promptscript/cli.svg)](https://www.npmjs.com/package/@promptscript/cli)\n[![Docker](https://img.shields.io/badge/docker-ghcr.io-blue)](https://github.com/mrwogu/promptscript/pkgs/container/promptscript)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![VS Code](https://img.shields.io/badge/VS_Code-Extension-007ACC?logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=promptscript.promptscript-language)\n\n[**Try Playground**](https://getpromptscript.dev/playground/) · [**Documentation**](https://getpromptscript.dev/) · [**Quick Start**](#quick-start) · [**VS Code Extension**](https://marketplace.visualstudio.com/items?itemName=promptscript.promptscript-language)\n\n\u003c/div\u003e\n\n---\n\n## The Problem\n\n- ❌ Even 2–3 AI tools × many repos = **dozens of config files** drifting out of sync\n- ❌ Security policy update? Manual changes across every repo, for every tool\n- ❌ Switching from Copilot to Codex? Rewrite instructions, READMEs, and docs everywhere\n- ❌ No audit trail, no inheritance, no validation\n\n## The Fix\n\n- ✅ Write once in `.prs` → compile to **all 37 agents**\n- ✅ Update the source → propagates everywhere automatically\n- ✅ Hierarchical inheritance like code, not copy-paste\n- ✅ Full validation, audit trail, and version pinning\n\n---\n\n## Quick Start\n\n### Install \u0026 Run\n\n```bash\nnpm install -g @promptscript/cli\n\nprs init       # auto-detects your tech stack\nprs compile    # outputs to all AI tools\n```\n\n### Or Use Docker\n\n```bash\ndocker run --rm -v $(pwd):/workspace ghcr.io/mrwogu/promptscript:latest compile\n```\n\n### Or Try Online\n\n**[Open Playground](https://getpromptscript.dev/playground/)** - no install needed.\n\n### Set Up Hooks\n\n```bash\nprs hooks install    # auto-compiles on .prs save, protects generated files\n```\n\nFrom now on, every time you edit a `.prs` file, outputs recompile automatically. AI agents are blocked from overwriting generated configs.\n\n### Then Let Your AI Agents Take Over\n\nAfter `prs compile`, a **PromptScript language skill** is automatically injected into your AI agents. They learn the `.prs` syntax and can create, edit, and manage your PromptScript files for you. Just ask your agent to add a new rule, change a standard, or create a shortcut — it already knows how.\n\n---\n\n## See It In Action\n\n[![Watch the video](docs/assets/images/demo-video-thumb.jpg)](https://youtu.be/7sHMn-DbZig)\n\n**Source:** `.promptscript/project.prs`\n\n```promptscript\n@meta { id: \"checkout-service\" syntax: \"1.0.0\" }\n\n@inherit @company/backend-security\n@use @fragments/testing\n@use @fragments/typescript-strict\n\n@identity {\n  \"\"\"\n  You are an expert Backend Engineer working on the Checkout Service.\n  This service handles payments using hexagonal architecture.\n  \"\"\"\n}\n\n@shortcuts {\n  \"/review\": \"Security-focused code review\"\n  \"/test\": \"Write unit tests with Vitest\"\n  \"/migrate\": \"Generate Prisma migration\"\n}\n```\n\n**Run:** `prs compile` generates native config files for every AI tool:\n\n```\n📄 .github/copilot-instructions.md\n📄 CLAUDE.md\n📄 .cursor/rules/project.mdc\n📄 .agent/rules/project.md\n📄 AGENTS.md\n📄 OPENCODE.md\n📄 GEMINI.md\n   ... and 30 more agent formats\n```\n\n**Example output** - the generated `CLAUDE.md`:\n\n```markdown\n# CLAUDE.md\n\nYou are an expert Backend Engineer working on the Checkout Service.\nThis service handles payments using hexagonal architecture.\n\n## Code Style\n\n- Use strict mode\n- Prefer interfaces over types\n- Never use `any` type\n\n## Commands\n\n- `/review` - Security-focused code review\n- `/test` - Write unit tests with Vitest\n- `/migrate` - Generate Prisma migration\n```\n\nOne `.prs` file. Every AI tool gets native, idiomatic output. No manual formatting.\n\n---\n\n## Key Features\n\n**Hierarchical Inheritance** - compose standards from organization → team → project level, just like code:\n\n```promptscript\n@inherit @company/global-security\n@inherit @team/backend-standards\n@extend @standards.testing { coverage: \"95%\" }\n```\n\n**Parameterized Templates** - reusable stacks with typed parameters, like Infrastructure as Code:\n\n```promptscript\n@inherit @stacks/typescript-service(projectName: \"checkout\", port: 8080)\n```\n\n**Skills** - define reusable AI skills with `SKILL.md` files, resource bundles, and input/output contracts. Compile them to native skill formats for Claude Code, Copilot, Cursor, and more:\n\n```promptscript\n@skills {\n  deploy: {\n    description: \"Deploy service to production\"\n    userInvocable: true\n    allowedTools: [\"Bash\", \"Read\"]\n  }\n}\n```\n\n**Registry Resolver** - import from any Git repository with Go-style URL imports or short aliases. Auto-discovers skills from repos that don't have `.prs` files. Lockfile support for reproducible builds. Vendor mode for offline/air-gapped CI:\n\n```promptscript\n# Alias (configured once in promptscript.yaml)\n@use @company/security\n\n# Or direct URL import — no config needed\n@use github.com/acme/shared-standards/@fragments/security@^1.0.0\n```\n\n```yaml\n# promptscript.yaml\nregistries:\n  '@company': github.com/acme/promptscript-base\n```\n\n**AI-Assisted Migration** - already have `CLAUDE.md` or `.cursorrules`? Convert automatically:\n\n```bash\nprs init --migrate\n```\n\n**Watch Mode** - auto-recompile on every change:\n\n```bash\nprs compile --watch\n```\n\n**Zero Learning Curve** - A PromptScript language skill is automatically compiled into your AI agents' native skill format. Your agents learn the syntax, so _they_ manage your `.prs` files — you just tell them what you want in plain language.\n\n**Docker CI/CD** - validate in any pipeline:\n\n```bash\ndocker run --rm -v $(pwd):/workspace ghcr.io/mrwogu/promptscript:latest validate --strict\n```\n\n---\n\n## 37 AI Agents, One Source\n\nPromptScript compiles to native config formats for every major AI coding agent:\n\n- 🟢 **GitHub Copilot** → `.github/copilot-instructions.md`\n- 🟢 **Claude Code** → `CLAUDE.md`, `.claude/skills/*.md`\n- 🟢 **Cursor** → `.cursor/rules/*.mdc`\n- 🟢 **Google Antigravity** → `.agent/rules/*.md`\n- 🟢 **Factory AI** → `AGENTS.md`\n- 🟢 **OpenCode** → `OPENCODE.md`\n- 🟢 **Gemini CLI** → `GEMINI.md`\n\nPlus **30 more**: Windsurf, Cline, Roo Code, Codex, Continue, Augment, Goose, Kilo Code, Amp, Trae, Junie, Kiro CLI, and others. Each outputs to its native config path. See the [full list of formatters](https://getpromptscript.dev/formatters/).\n\n---\n\n## Enterprise Ready\n\n- 🔒 **Private registries** - host standards on internal Git repos\n- 📌 **Version pinning** - `@inherit @company/security@2.1.0`\n- ✅ **CI validation** - `prs validate --strict --output json`\n- 📋 **Full audit trail** - all changes tracked in version control\n\n---\n\n## Documentation\n\n| Resource                                                                                                        | Description                                |\n| :-------------------------------------------------------------------------------------------------------------- | :----------------------------------------- |\n| [**Getting Started**](https://getpromptscript.dev/getting-started/)                                             | 5-minute quickstart guide                  |\n| [**Language Reference**](https://getpromptscript.dev/reference/syntax/)                                         | Full syntax documentation                  |\n| [**Guides**](https://getpromptscript.dev/guides/)                                                               | Inheritance, registry, migration, and more |\n| [**Enterprise**](https://getpromptscript.dev/guides/enterprise/)                                                | Scaling across organizations               |\n| [**VS Code Extension**](https://marketplace.visualstudio.com/items?itemName=promptscript.promptscript-language) | Syntax highlighting for `.prs` files       |\n\n---\n\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md). \u0026nbsp;|\u0026nbsp; [**Full Roadmap →**](ROADMAP.md)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eBuilt for the AI-First Engineering Community\u003c/sub\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \u003ca href=\"https://getpromptscript.dev/\"\u003eDocumentation\u003c/a\u003e · \u003ca href=\"https://getpromptscript.dev/playground/\"\u003ePlayground\u003c/a\u003e · \u003ca href=\"https://github.com/mrwogu/promptscript/issues\"\u003eIssues\u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrwogu%2Fpromptscript","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrwogu%2Fpromptscript","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrwogu%2Fpromptscript/lists"}