Documentation

Getting Started

Creating Your Account

To get started with Prompt Repo, you'll need to create an account:

1. Click the "Start free" button on the homepage
2. Sign up using your email address (authentication is handled by WorkOS)
3. Verify your email if required
4. You'll be automatically signed in and redirected to your dashboard

New accounts start on the Free plan, which includes up to 5 prompts and full version history. You can upgrade to Pro at any time to unlock unlimited prompts and team collaboration features.

Creating Your First Prompt

Once you're logged in, creating your first prompt is simple:

1. Navigate to the Prompts section from the sidebar
2. Click the "New Prompt" button
3. Enter a title for your prompt (e.g., "Customer Support Agent")
4. Optionally add a description to help you remember what this prompt does
5. Write your prompt content in the text area
6. If you're on a team, you can assign the prompt to that team
7. Click "Create Prompt" to save

Your prompt is now saved and ready to use. You can test it, create variants, or run experiments.

Setting Up Your API Key

To test prompts and run experiments, you'll need an OpenRouter API key:

1. Get an API key from OpenRouter (if you don't have one)
2. Navigate to Settings → API Key
3. Paste your OpenRouter API key
4. Click "Save API Key"

Your API key is encrypted using AES-256-GCM encryption before being stored. Only a fingerprint (partial preview) is displayed for identification purposes. The key is only decrypted when needed for API calls.

Core Features

Prompt Management

Prompt Repo helps you organize and manage all your prompts in one place:

• View all prompts: See all your prompts in a card-based list view
• Search and filter: Quickly find prompts by title or description
• Edit prompts: Update prompt titles, descriptions, and content at any time
• Archive prompts: Hide prompts you're not actively using without deleting them
• Delete prompts: Permanently remove prompts you no longer need

Version History

Every time you update a prompt, Prompt Repo automatically creates a new version:

• All previous versions are preserved
• View the complete history of changes
• Compare different versions side-by-side
• Restore previous versions if needed
• See when each version was created and by whom

This version history is available on both Free and Pro plans, giving you full control over your prompt evolution.

Variant Testing

Variants allow you to branch off from your base prompt to test different approaches:

1. Open a prompt to view its details
2. Click "Create Variant" from any version
3. Modify the prompt content to test a different approach
4. Test both the base prompt and variants to compare results
5. Promote a variant to become the new base prompt if it performs better

Variants are perfect for A/B testing different prompt strategies, tone adjustments, or structural changes.

Experiments

Experiments let you test prompts against multiple models and configurations:

1. Create an experiment from the Experiments section
2. Select one or more prompts to test
3. Choose the LLM models you want to test against
4. Configure test parameters (temperature, max tokens, etc.)
5. Run the experiment and view results
6. Compare outputs side-by-side
7. Rate responses to track which prompts perform best

Experiments help you make data-driven decisions about which prompts work best for your use case. You can see token usage, costs, latency, and response quality all in one place.

Team Collaboration

Creating a Team

Team collaboration is available on the Pro plan. To create a team:

1. Navigate to the Teams section
2. Click "New Team"
3. Enter a team name
4. Click "Create Team"

You'll automatically become the team owner. As the owner, you can invite members, manage roles, and configure team settings.

Inviting Team Members

To invite members to your team:

1. Open your team from the Teams section
2. Click "Invite Member"
3. Enter the email address of the person you want to invite
4. They must already have a Prompt Repo account with that email
5. Click "Send Invitation"

The invited member will receive a notification and can accept the invitation. Once they join, they'll have access to all team prompts and experiments.

Sharing Prompts with Teams

When creating or editing a prompt, you can assign it to a team:

• All team members can view and edit team prompts
• Team members receive notifications when prompts are created or updated
• Team prompts appear in each member's prompt list
• Version history shows who made each change

Team Roles

Teams have two roles:

• Owner: Can invite/remove members, change roles, manage team API keys, and delete the team
• Collaborator: Can create and edit team prompts, run experiments, and view team content

Only the team owner can manage team membership and settings.

API Keys

Personal API Keys

Your personal API key is used when testing prompts that aren't assigned to a team:

• Stored securely with AES-256-GCM encryption
• Only decrypted when needed for API calls
• You can update or remove it at any time
• Visible only to you

Team API Keys

Teams can have their own API key for shared usage:

• Only team owners can set or update the team API key
• Used automatically when testing team prompts
• Team members can see the key fingerprint but not the actual key
• All team members benefit from shared API usage

You can either enter a team API key manually or apply your personal key to the team. When applying your personal key, it's copied to the team (not moved), so you can still use it personally.

Security Best Practices

• Never share your API key: Keep it private and secure
• Use team keys for collaboration: Don't share personal keys with team members
• Rotate keys regularly: Update your keys periodically for better security
• Monitor usage: Check your OpenRouter dashboard for unusual activity
• Use separate keys: Consider using different keys for different projects or teams

Billing & Plans

Free Plan

The Free plan is perfect for individuals getting started:

• Up to 5 prompts
• Full version history for all prompts
• Testing with your own OpenRouter API key
• Prompt variants and comparison features
• Basic experiment features
• No team collaboration

The Free plan is available at no cost and doesn't require a payment method.

Pro Plan

The Pro plan unlocks advanced features:

• Unlimited prompts
• Full team collaboration features
• Unlimited team members
• Team API key management
• Advanced experiment features
• Priority support

Pricing: €7.99 per month, billed monthly in advance.

Free Trial

New users are eligible for a 14-day free trial of the Pro plan:

• Begins when you sign up for a Pro subscription
• Provides full Pro plan features during the trial period
• Requires a valid payment method to start
• Automatically converts to a paid subscription after 14 days unless cancelled
• Available only once per user

Managing Your Subscription

You can manage your subscription from the Settings → Billing page:

• View your current plan and billing cycle
• Upgrade from Free to Pro
• Cancel your subscription (access continues until end of billing period)
• Access the Stripe Customer Portal for payment method management
• View billing history

When you cancel, your subscription remains active until the end of the current billing period. After that, your account automatically downgrades to the Free plan.

Need More Help?

If you have questions or need assistance:

• Check out our blog for tips and best practices
• Visit our support page to contact us
• Review our Terms of Service and Privacy Policy