Promptyard

Promptyard is a CLI tool that installs agents, prompts, and skills from Git repositories into your local project. It supports Claude, GitHub Copilot, and OpenCode as deployment targets.

Installation

Download the latest binary for your platform from the GitHub Releases page and place it somewhere on your PATH.

Platform	File
Linux x64	promptyard-linux-x64
Linux ARM64	promptyard-linux-arm64
macOS (Apple Silicon)	promptyard-mac-arm64
Windows x64	promptyard-win-x64.exe
Windows ARM64	promptyard-win-arm64.exe

⚠️ The MacOS version is currently broken due to code signing issues, we're working on a fix.

Usage

Initialize a project

Run this once in the root of your project to set up Promptyard:

promptyard init --tool <claude|copilot|opencode>

This creates a .promptyard/ directory with your configuration.

Add a repository

Install agents and skills from a Git repository:

promptyard add <name> <url>

Example:

promptyard add my-agents https://github.com/example/ai-agents.git

Use --force to overwrite existing files without being prompted.

Update repositories

Pull the latest changes and redeploy:

promptyard update            # updates all repositories
promptyard update <name>     # updates a specific repository

Remove a repository

Unregister a repository from the project:

promptyard remove <name>

Note: deployed files are left in place and must be removed manually.

Contributing

Contributions are welcome. Bun is required to build and test the project.

# Install dependencies
bun install

# Run tests
bun test

# Type-check
bun run typecheck

# Lint
bun run lint

Follow the red-green-refactor approach: write a failing test first, make it pass, then clean up. Keep tests focused — one test per behavior.

When adding a new deployment target, implement the Deployer interface in src/deployment/ and register it in src/deployment/index.ts.

Open a pull request against main with a clear description of what changed and why.

Authors

• Willem Meints
• Mika Krooswijk