Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -404,6 +404,7 @@ FodyWeavers.xsd
/frontend/dist-electron
frontend/.env*
backend/.env*
*.tsbuildinfo

# Claude Code / AI agent files
CLAUDE.md
Expand Down
6 changes: 3 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ The project is a monorepo with local packages that must be built in order:

```bash
# 1. Clone the repo
git clone https://github.com/Prompd/prompd.app.git
cd prompd.app
git clone https://github.com/prompd/prompd-app.git
cd prompd-app

# 2. Build @prompd/scheduler (required by frontend)
cd packages/scheduler && npm install && npm run build
Expand Down Expand Up @@ -97,7 +97,7 @@ For detailed architecture, see [CLAUDE.md](CLAUDE.md).

## Reporting Issues

- Use [GitHub Issues](https://github.com/Prompd/prompd.app/issues)
- Use [GitHub Issues](https://github.com/prompd/prompd-app/issues)
- Include steps to reproduce, expected vs actual behavior
- For security vulnerabilities, email security@prompd.app instead of opening a public issue

Expand Down
80 changes: 18 additions & 62 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -1,99 +1,55 @@
Elastic License 2.0
Elastic License 2.0 (ELv2)

URL: https://www.elastic.co/licensing/elastic-license
Copyright 2024-2026 Prompd LLC

## Acceptance

By using the software, you agree to all of the terms and conditions below.

## Copyright License

The licensor grants you a non-exclusive, royalty-free, worldwide,
non-sublicensable, non-transferable license to use, copy, distribute, make
available, and prepare derivative works of the software, in each case subject to
the limitations and conditions below.
The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject to the limitations and conditions below.

## Limitations

You may not provide the software to third parties as a hosted or managed
service, where the service provides users with access to any substantial set of
the features or functionality of the software.
You may not provide the software to third parties as a hosted or managed service, where the service provides users with access to any substantial set of the features or functionality of the software.

You may not move, change, disable, or circumvent the license key functionality
in the software, and you may not remove or obscure any functionality in the
software that is protected by the license key.
You may not move, change, disable, or circumvent the license key functionality in the software, and you may not remove or obscure any functionality in the software that is protected by the license key.

You may not alter, remove, or obscure any licensing, copyright, or other notices
of the licensor in the software. Any use of the licensor's trademarks is subject
to applicable law.
You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.

## Patents

The licensor grants you a license, under any patent claims the licensor can
license, or becomes able to license, to make, have made, use, sell, offer for
sale, import and have imported the software, in each case subject to the
limitations and conditions in this license. This license does not cover any
patent claims that you cause to be infringed by modifications or additions to
the software. If you or your company make any written claim that the software
infringes or contributes to infringement of any patent, your patent license for
the software granted under these terms ends immediately. If your company makes
such a claim, your patent license ends immediately for work on behalf of your
company.
The licensor grants you a license, under any patent claims the licensor can license, or becomes able to license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case subject to the limitations and conditions in this license. This license does not cover any patent claims that you cause to be infringed by modifications or additions to the software. If you or your company make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.

## Notices

You must ensure that anyone who gets a copy of any part of the software from you
also gets a copy of these terms.
You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms.

If you modify the software, you must include in any modified copies of the
software prominent notices stating that you have modified the software.
If you modify the software, you must include in any modified copies of the software prominent notices stating that you have modified the software.

## No Other Rights

These terms do not imply any licenses other than those expressly granted in
these terms.
These terms do not imply any licenses other than those expressly granted in these terms.

## Termination

If you use the software in violation of these terms, such use is not licensed,
and your licenses will automatically terminate. If the licensor provides you
with a notice of your violation, and you cease all violation of this license no
later than 30 days after you receive that notice, your licenses will be
reinstated retroactively. However, if you violate these terms after such
reinstatement, any additional violation of these terms will cause your licenses
to terminate automatically and permanently.
If you use the software in violation of these terms, such use is not licensed, and your licenses will automatically terminate. If the licensor provides you with a notice of your violation, and you cease all violation of this license no later than 30 days after you receive that notice, your licenses will be reinstated retroactively. However, if you violate these terms after such reinstatement, any additional violation of these terms will cause your licenses to terminate automatically and permanently.

## No Liability

As far as the law allows, the software comes as is, without any warranty or
condition, and the licensor will not be liable to you for any damages arising
out of these terms or the use or nature of the software, under any kind of
legal claim.
*As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.*

## Definitions

The "licensor" is the entity offering these terms, and the "software" is the
software the licensor makes available under these terms, including any portion
of it.
The **licensor** is the entity offering these terms, and the **software** is the software the licensor makes available under these terms, including any portion of it.

"you" refers to the individual or entity agreeing to these terms.
**you** refers to the individual or entity agreeing to these terms.

"your company" is any legal entity, sole proprietorship, or other kind of
organization that you work for, plus all organizations that have control over,
are under the control of, or are under common control with that
organization. "control" means ownership of substantially all the assets of an
entity, or the power to direct its management and policies by vote, contract, or
otherwise. Control can be direct or indirect.
**your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.

"your licenses" are all the licenses granted to you for the software under
these terms.
**your licenses** are all the licenses granted to you for the software under these terms.

"use" means anything you do with the software requiring one of your licenses.
**use** means anything you do with the software requiring one of your licenses.

"trademark" means trademarks, service marks, and similar rights.

---

Licensor: Logikbug LLC (dba Prompd)
Software: Prompd Desktop Application
Copyright 2025-2026 Logikbug LLC. All rights reserved.
**trademark** means trademarks, service marks, and similar rights.
12 changes: 9 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,12 @@ Prompd brings software engineering practices to AI prompt development. Instead o

> **Platform:** Pre-built binaries are currently **Windows only**. Mac and Linux builds are coming soon. You can build from source on any platform today.

## Download

**[Download for Windows](https://github.com/prompd/prompd-app/releases/latest)** | [Build from Source](#quick-start)

**Requirements:** Windows 10+ | 4GB RAM | 500MB disk space

<!-- SCREENSHOT: Design View - Open a .prmd file in Design View showing the WYSIWYG editor
with the provider bar (Anthropic/OpenAI tabs), parameter panel, and content sections.
Use the public-examples/prompts/topic-researcher.prmd file for a good example. -->
Expand Down Expand Up @@ -55,7 +61,7 @@ Prompd brings software engineering practices to AI prompt development. Instead o
```bash
# Clone the repository
git clone https://github.com/Prompd/prompd-app.git
cd prompd.app
cd prompd-app

# Build local packages (required before frontend)
cd packages/scheduler && npm install && npm run build
Expand Down Expand Up @@ -106,7 +112,7 @@ The backend API is optional and only used for provider/model list updates, regis
### Project Structure

```
prompd.app/
prompd-app/
├── frontend/ # Electron + React application
│ ├── src/modules/ # Components, services, editor
│ ├── src/stores/ # Zustand state management
Expand Down Expand Up @@ -159,4 +165,4 @@ At minimum, you need one LLM provider API key (e.g., Anthropic or OpenAI) config

## License

See [LICENSE](LICENSE) for details.
Elastic License 2.0 (ELv2) - see [LICENSE](LICENSE) for details.
9 changes: 5 additions & 4 deletions backend/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

3 changes: 2 additions & 1 deletion backend/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
"version": "0.5.0-beta.1",
"description": "Node.js backend for Prompd Editor with MongoDB and WebSocket support",
"main": "src/server.js",
"license": "Elastic-2.0",
"type": "module",
"scripts": {
"dev": "nodemon src/server.js",
Expand All @@ -13,7 +14,7 @@
"dependencies": {
"@anthropic-ai/sdk": "^0.65.0",
"@google/generative-ai": "^0.24.1",
"@prompd/cli": "^0.5.0-beta.2",
"@prompd/cli": "file:../../prompd-cli/typescript",
"adm-zip": "^0.5.10",
"archiver": "^6.0.1",
"axios": "^1.6.2",
Expand Down
2 changes: 1 addition & 1 deletion backend/src/prompts/modes/agent.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
You are **Prompd Agent** — an intelligent AI assistant that helps users with .prmd prompt files, coding tasks, and package discovery.
You are **Fox** (*Friendly Orchestration eXecution Agent*) — an intelligent AI assistant that helps users with .prmd prompt files, coding tasks, and package discovery.

## Non-Negotiable Rules

Expand Down
2 changes: 1 addition & 1 deletion backend/src/prompts/modes/explore.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"label": "Explore",
"icon": "Search",
"description": "Discover packages in the registry",
"systemPrompt": "You are in **Explore Mode** - a registry search assistant.\n\n## CRITICAL: RESPOND ONLY WITH RAW JSON - NO MARKDOWN\n\nYou are NOT a prompt generator. You do NOT create .prmd files. You ONLY help users search the Prompd Registry for existing packages.\n\n## MANDATORY: RAW JSON ONLY\n\nDo NOT wrap your response in markdown code blocks. Do NOT add any text before or after the JSON.\nYour ENTIRE response must be ONLY this JSON object (no ```json, no explanation, just raw JSON):\n\n{\"message\": \"Searching for [topic]...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"kw1\", \"kw2\", \"kw3\", \"kw4\", \"kw5\"]}}\n\n## Examples - Note: NO markdown, JUST JSON\n\nUser: \"I need help writing blog posts\"\nYour response (the ENTIRE response, nothing else):\n{\"message\": \"Searching for blog writing tools...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"blog\", \"writer\", \"content\", \"article\", \"writing\"]}}\n\nUser: \"Something to analyze CSV files\"\nYour response:\n{\"message\": \"Searching for CSV analysis packages...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"csv\", \"data\", \"analyzer\", \"spreadsheet\", \"table\"]}}\n\nUser: \"Help me review code\"\nYour response:\n{\"message\": \"Searching for code review tools...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"code\", \"review\", \"analysis\", \"quality\", \"lint\"]}}\n\nUser: \"Generate marketing emails\"\nYour response:\n{\"message\": \"Searching for email marketing packages...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"email\", \"marketing\", \"newsletter\", \"campaign\", \"outreach\"]}}\n\n## Rules\n\n1. **OUTPUT RAW JSON ONLY** - No markdown code blocks, no explanation text\n2. **NEVER create or generate .prmd files** - That's Generate mode, not Explore mode\n3. **NEVER suggest creating a package** - Just search for existing ones\n4. **Include synonyms and related terms** - More keywords = better search results\n5. **If truly unclear** - Ask ONE quick clarifying question (as plain text), then on next message respond with JSON",
"systemPrompt": "You are in **Explore Mode** - a registry search assistant.\n\n## CRITICAL: RESPOND ONLY WITH RAW JSON - NO MARKDOWN\n\nYou are NOT a prompt generator. You do NOT create .prmd files. You ONLY help users search PrompdHub for existing packages.\n\n## MANDATORY: RAW JSON ONLY\n\nDo NOT wrap your response in markdown code blocks. Do NOT add any text before or after the JSON.\nYour ENTIRE response must be ONLY this JSON object (no ```json, no explanation, just raw JSON):\n\n{\"message\": \"Searching for [topic]...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"kw1\", \"kw2\", \"kw3\", \"kw4\", \"kw5\"]}}\n\n## Examples - Note: NO markdown, JUST JSON\n\nUser: \"I need help writing blog posts\"\nYour response (the ENTIRE response, nothing else):\n{\"message\": \"Searching for blog writing tools...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"blog\", \"writer\", \"content\", \"article\", \"writing\"]}}\n\nUser: \"Something to analyze CSV files\"\nYour response:\n{\"message\": \"Searching for CSV analysis packages...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"csv\", \"data\", \"analyzer\", \"spreadsheet\", \"table\"]}}\n\nUser: \"Help me review code\"\nYour response:\n{\"message\": \"Searching for code review tools...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"code\", \"review\", \"analysis\", \"quality\", \"lint\"]}}\n\nUser: \"Generate marketing emails\"\nYour response:\n{\"message\": \"Searching for email marketing packages...\", \"suggestion\": {\"type\": \"search-keywords\", \"keywords\": [\"email\", \"marketing\", \"newsletter\", \"campaign\", \"outreach\"]}}\n\n## Rules\n\n1. **OUTPUT RAW JSON ONLY** - No markdown code blocks, no explanation text\n2. **NEVER create or generate .prmd files** - That's Generate mode, not Explore mode\n3. **NEVER suggest creating a package** - Just search for existing ones\n4. **Include synonyms and related terms** - More keywords = better search results\n5. **If truly unclear** - Ask ONE quick clarifying question (as plain text), then on next message respond with JSON",
"followUpStrategies": {
"clear": "Extract keywords immediately and return search-keywords JSON",
"vague": "Ask ONE clarifying question about the domain/purpose, then search",
Expand Down
4 changes: 2 additions & 2 deletions backend/src/prompts/modes/help-chat.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,11 +51,11 @@ Top toolbar dropdowns select the LLM provider (OpenAI, Anthropic, Google, Groq,

You are here to help users explore and learn about Prompd -- how features work, what file formats look like, how to configure things, etc. You are **not** able to create, edit, or modify files, run commands, or take any actions in the app.

When a user asks you to create files, write code, build workflows, or do anything that requires acting on their workspace, direct them to the **Prompd Agent**. Look for the **P icon** -- it appears throughout the app (in the left sidebar, in the editor toolbar, etc.) and always opens the Prompd Agent. The Prompd Agent is a separate assistant that can read, write, search files, and execute commands in the user's workspace. That is the right tool for hands-on work.
When a user asks you to create files, write code, build workflows, or do anything that requires acting on their workspace, direct them to **Fox**. Look for the **P icon** -- it appears throughout the app (in the left sidebar, in the editor toolbar, etc.) and always opens the Fox. The Fox is a separate assistant that can read, write, search files, and execute commands in the user's workspace. That is the right tool for hands-on work.

## Rules

1. Only answer questions about using Prompd. If asked about unrelated topics, politely redirect.
2. You cannot modify files, execute code, or perform any actions in the app. You are informational only. Do not offer to write code snippets or YAML for the user to copy -- direct them to the Prompd Agent instead.
2. You cannot modify files, execute code, or perform any actions in the app. You are informational only. Do not offer to write code snippets or YAML for the user to copy -- direct them to the Fox instead.
3. Keep answers concise and practical. Use bullet points for steps.
4. If you are unsure about a specific feature detail, say so rather than guessing.
4 changes: 3 additions & 1 deletion docs/AGENT-INTEGRATION-PLAN.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
# Prompd Agent Integration Architecture
# Fox Integration Architecture

> **Fox** — *Friendly Orchestration eXecution Agent*

## Overview

Expand Down
4 changes: 2 additions & 2 deletions frontend/ELECTRON.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,8 +163,8 @@ The Electron app is configured for auto-updates via `electron-builder`. To enabl
"build": {
"publish": {
"provider": "github",
"owner": "Logikbug",
"repo": "editor.prompdhub.ai"
"owner": "prompd",
"repo": "prompd-app"
}
}
```
Expand Down
Loading
Loading