Skip to content

tamaygz/promptArq

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

237 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

promptArq

promptArq Logo

promptArq - architeqt ur prompts <3

Create, version, improve, and collaborate on AI prompts with your team. Built for prompt engineers, developers, and AI practitioners.

License: MIT TypeScript React

Try it now | User Guide | Windows App


########################################################################################################################################################################################################

D I S C L A I M E R

Everything here is AI Generated. UI, Code, Content, ALL OF IT. Backstory: For a while I was lookin for a reason to play with github spark and also parallel for a way to not write my prompts over and over again. Existing software either didnt meet my needs or was to expensive, so I created this spark project. Happy to chat about it, there's no "active" development. Use it, leave it, up to you :-)

Here's the public spark url / DEMO: https://arqioly-prompt-atom--tamaygz.github.app/

########################################################################################################################################################################################################


🎯 What is promptArq?

promptArq is a comprehensive prompt management system for teams and individuals working with Large Language Models. It provides a structured environment for creating, versioning, improving, and sharing AI prompts.

Think of it as Git for AI prompts - with built-in intelligence to help you write better prompts, track changes over time, and expose them to AI agents through MCP (Model Context Protocol).

image

✨ Features

Flexible Authentication

  • Spark Mode: Automatic authentication via Spark runtime
  • Standalone Mode: GitHub OAuth integration
  • Seamless switching between modes
  • Secure token management with PKCE flow

πŸ“ Prompt Management

  • Rich text editor with syntax highlighting
  • Support for variable placeholders ({{variableName}})
  • Project-level variables ({{{projectVar}}}) - define once, use everywhere
  • Fill placeholders and execute prompts directly in the UI
  • Use LLMs with custom system prompts to improve or execute your prompts
  • Version control for every change
  • AI-powered prompt improvements
  • Duplicate and template support
  • Full-text search across all prompts

πŸ—‚οΈ Organization

  • Projects - Top-level containers with reusable variables
  • Categories - Within-project organization
  • Tags - Flexible cross-project labels with colors
  • Smart tag suggestions based on usage

πŸ”„ Version Control

  • Complete history for every prompt
  • Visual diffs between versions
  • Restore any previous version
  • Track changes with timestamps

🀝 Team Collaboration

  • Create teams with role-based access (Owner/Admin/Editor/Viewer)
  • Share individual prompts via links
  • Comments and discussions
  • User presence indicators

🎯 Templates & Placeholders

  • 50+ pre-built templates (Marketing, Development, QA, Strategy, etc.)
  • Manual placeholders: {{variableName}} - fill each time
  • Project variables: {{{projectVar}}} - auto-replaced from project settings
  • Remembered values for repeated use
  • Cinema mode template browser

βš™οΈ Advanced Configuration

  • System prompts with priority resolution (prompt β†’ project β†’ category β†’ tag): Reusable instructions for consistent AI behavior
  • Model configs (temperature, max tokens, top_p)
  • Pre-configured templates
  • Import/export prompts as JSON

πŸ”Œ MCP Integration

  • Expose prompts via MCP to other agents
  • Model Context Protocol support
  • Enable/disable per prompt
  • Organized by project

🎨 Modern UI

  • Clean, responsive interface
  • Dark mode (follows system preference)
  • Smooth animations
  • Collapsible sidebar
  • Mobile-friendly design

πŸš€ Quick Start

Web App

Try it now: https://arqioly-prompt-atom--tamaygz.github.app/

Run locally:

git clone https://github.com/tamaygz/promptArq.git
cd promptArq
npm install
npm run dev

Open http://localhost:5173

Note: Requires GitHub OAuth setup for authentication. See docs/DeveloperGuide.md for details.

Windows Desktop App

A native Windows application with global hotkeys and system tray integration:

cd WindowsApp
build.bat

Run the generated .exe file. The Vite server starts automatically.

Features:

  • Global hotkey (Ctrl+Alt+P) to show/hide
  • System tray integration
  • Automatic Vite server management
  • WebView2-based native window

Windows App Documentation | Quick Start


πŸ“– Documentation


πŸ—οΈ Technology Stack

Web App:

  • React 19 + TypeScript + Vite
  • Tailwind CSS 4 + Radix UI
  • Dual storage: Spark KV or localStorage
  • Express OAuth proxy server

Windows App:

  • .NET 8.0 Windows Forms
  • WebView2 integration
  • Global hotkey manager
  • System tray support

πŸ“Έ Screenshots

Main Dashboard

Main dashboard

Prompt Editor

Prompt editor

Template Library

Template library

🀝 Contributing

Contributions welcome! See docs/DeveloperGuide.md for setup instructions.

  1. Fork the repository
  2. Create feature branch: git checkout -b feature/my-feature
  3. Make changes and test
  4. Commit: git commit -m "Add my feature"
  5. Push: git push origin feature/my-feature
  6. Open Pull Request

πŸ“„ License

MIT License. See LICENSE for details.


πŸ™ Acknowledgments


Made with ❀️ for prompt engineers

About

Create, version, improve, and collaborate on AI prompts with your team. Built for prompt engineers, developers, and AI practitioners.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Contributors