Promptex 🚀

Turn your local codebase into LLM-ready context in seconds.

Promptex is a zero-config, localhost web interface that helps you select, visualize, and bundle your code files for Large Language Models (Claude, ChatGPT, DeepSeek).

It solves the copy-paste fatigue by providing a clean "Switchboard" UI to toggle files, estimate tokens, and format everything into a single prompt.

✨ Features

• 📂 Visual File Picker — Recursively scans your directory, ignoring node_modules and .git automatically.
• 🔗 Linked Mode (Auto-Resolve) — Click one file and it auto-selects all its imports.
• ⚡ Minify Mode — Removes comments and whitespace to shrink tokens.
• 🛑 Smart .gitignore — Respects your project's existing ignore rules.
• 💾 Presets — Save groups like Auth Stack, DB Schema, etc.
• 💲 Cost Estimator — Live token + price estimation for GPT-4o / Claude Sonnet.
• 🔒 Secure & Local — Runs only on your machine; nothing is uploaded.

🚀 Quick Start

You don't need to install anything. Just run it inside any project folder:

npx promptex

Your dashboard opens at: http://localhost:3456

Global Installation (Optional)

npm install -g promptex

Then run:

promptex

🛠 Usage & Options

Start Normally

promptex

Custom Port

promptex -p 8080

Headless (No Browser Auto-Open)

promptex --no-open

Help

promptex --help

💡 Pro Tips

1. Linked Mode saves time Select one file (like a React component) → Promptex auto-grabs all imported utilities and sub-components.

2. XML vs Markdown Output

   • XML (<file path="...">...</file>) is best for Claude.
   • Markdown (```js) works well with ChatGPT.

3. Use Presets Working on a big feature? Select the files → Name it in the header → Save Preset → Load anytime.

📦 Troubleshooting

Permission Denied on Linux/Mac?

Try:

sudo npx promptex

Or fix global npm permissions (recommended).

Port Already in Use?

promptex -p 4000

🤝 Contributing

1. Fork the repo
2. Create a branch
3. Commit changes
4. Open a Pull Request

📄 License

MIT © Vedant020000