Turn any codebase into a single, clean prompt – in seconds.
Promptor is a tiny macOS app that lets you drag-in a folder and drag-out a perfectly-formatted prompt ready for ChatGPT (or any LLM).
No server-side processing, no API keys, no rate limits – just a local SwiftUI app that gives you the full context of your project in one click.
“I built Promptor after realising I was paying US $0.30 per O3 request in Cursor. With ChatGPT Plus I already get 100 O3 requests every week… so why not copy the entire repo into the chat? Promptor is that copy-and-paste button.” – @edrickdch
- One-click import – choose any folder; Promptor filters out binaries, images, build artefacts, etc.
- Smart ignore rules – defaults modelled after
.gitignore
+ binary/media filters; adjustable before every import. - Folder-aware selection – recursively include/exclude sub-trees with a single checkbox; selection counts update live.
- Live token counter – rough GPT-token estimate so you know when to stop adding files.
- Template system – swap between
Default
,ChatML
, or roll your own with{{files}}
placeholder. - Security-scoped bookmarks – full sandbox compliance; Promptor never uploads or phones home.
- Zero dependencies – pure Swift + SwiftUI, 100 % local.
git clone https://github.com/edrickdch/Promptor.git
open Promptor/Promptor.xcodeproj # or .xcworkspace if you add packages
- Xcode 15 or newer
- macOS 14 (Sonoma) SDK
Press ⌘R
to run. The first time you import a folder macOS will ask for permissions; Promptor stores a security-scoped bookmark so you don’t have to re-grant every launch.
- Add Folder → pick your repo
- (Optional) tweak ignore suffixes / folders
- Check the files or folders you want
- Copy → paste into ChatGPT (or anywhere)
Done.
Setting | Location | Default |
---|---|---|
Include sub-folders | Import sheet | ✅ |
Ignore suffixes | Import sheet (comma-sep) | .png,.jpg,.zip,… |
Ignore folders | Import sheet (comma-sep) | node_modules,build,.git,… |
Max file size | AppSettings.maxFileSize |
500 KB |
Edit Models.swift
to change globals.
- Simple & Easy to Use
- Open Source
- Free
PRs welcome! Please open an issue first if you’re planning a major change.
git checkout -b feature/your-awesome-feature
git commit -m "Add amazing thing"
git push origin feature/your--awesome-feature
MIT © 2025 Edrick Da Corte Henriquez. See LICENSE
for details.