Skip to content

MiaAI-Lab/repoprompt-windows

Repository files navigation

🔄 RepoPrompt for Windows

A context engineering tool for AI coding agents.
Curate your code. Control your context. Build better prompts.

Buy Me a Coffee at ko-fi.com

Release License Windows Size Built With



RepoPrompt Screenshot RepoPrompt Screenshot 2


📥 Download · ✨ Features · 💡 Workflow · 🐛 Report Bug


What is RepoPrompt for Windows?

RepoPrompt is a context engineering tool for AI coding agents. It solves a simple but critical problem:

When you paste a codebase into ChatGPT, Claude, Gemini, or any LLM — you are paying by the token. Every irrelevant file is wasted context and wasted money. RepoPrompt lets you surgically select which files to include, slice them to specific line ranges, track your token budget, and generate clean, LLM-optimized XML output.

Think of it as a curated context window builder for your codebase.


Why RepoPrompt?

RepoPrompt Raw copy/paste
File tree + structure ✅ Automatic file map included ❌ Manual
Token counting ✅ Per-file and total with budget warnings ❌ Blind guessing
Line-range slicing ✅ Include only relevant sections ❌ Whole file or nothing
.gitignore-aware ✅ Respects existing ignore rules ❌ Risk of leaking secrets/configs
Git diff support ✅ Include staged/unstaged changes ❌ Manual git diff
Output format ✅ XML/Markdown/Text — optimized for LLMs ❌ Raw, unstructured
MCP server ✅ External agents can query your workspace ❌ Not possible
Copy to clipboard ✅ One-click ❌ Manual select + copy

✨ Features

  • 📁 Multi-root workspace — Open one or more folders. Browse the full file tree.
  • 🔍 File browser with search — Filter files by name, extension, or path. Checkboxes for selection.
  • 💰 Token budget management — See token counts per file and total. Set a budget slider — get warned when you exceed it.
  • ✂️ Line-range slicing — Don't need the whole file? Select specific line ranges to include only what matters.
  • 🚫 Smart ignore — Respects .gitignore, .repoprompt-ignore, and custom ignore patterns. Automatically skips binaries, images, and common noise.
  • 📋 LLM-optimized output — Generates clean XML (Repomix-style <context> format), Markdown, or plain text. One-click copy to clipboard or save as .txt/.md/.xml.
  • 🔄 Git integration — Detects git repos, shows branch info, and can include staged/unstaged diffs in your context.
  • 🔌 Basic MCP server — Expose your workspace context to external AI agents via a JSON-RPC TCP server.
  • ⚙️ Customizable — Default ignore patterns, hidden file visibility, max file size, output format preferences.

💡 Workflow

1. Open a project folder
   ↓
2. Browse the file tree — search, filter, select
   ↓
3. (Optional) Set line ranges on specific files
   ↓
4. Set your token budget (slider)
   ↓
5. Hit "Build Context"
   ↓
6. Copy to clipboard or save as .xml/.md/.txt
   ↓
7. Paste into ChatGPT, Claude, Gemini, Cursor, or any AI tool

That's it. No accounts. No cloud. No telemetry. Just a curated context window for your AI pair programmer.


Who is this for?

  • Developers using AI coding agents — ChatGPT, Claude, Gemini, Cursor, Copilot, Codex CLI, etc.
  • Anyone who pastes code into LLMs and wants to control token usage
  • Teams sharing code context — generate standardized context files for reproducible AI interactions
  • Agent orchestration — when you want an external agent (via MCP) to understand your full project structure

Installation

Download the latest installer from the Releases page:

Download MSI Download Setup EXE

  • MSI — Windows Installer package. Supports silent/unattended installation via msiexec.
  • Setup EXE — NSIS-based installer with a graphical setup wizard.

Requirements

  • Windows 10 or 11
  • WebView2 (included with Windows 10/11; install the Evergreen Runtime if missing)

Development Setup

Prerequisites

Get started

# Clone the repository
git clone https://github.com/MiaAI-Lab/repoprompt-windows.git
cd repoprompt-windows

# Install frontend dependencies
npm install

# Run in development mode (hot-reload)
npm run tauri dev

Build production installers

npm run tauri build

Output installers are written to:

  • src-tauri/target/release/bundle/msi/RepoPrompt_{version}_x64_en-US.msi
  • src-tauri/target/release/bundle/nsis/RepoPrompt_{version}_x64-setup.exe

Run tests

cd src-tauri && cargo test

Project Layout

repoprompt-windows/
├── src/                          React + TypeScript frontend
│   ├── App.tsx                    Main layout (5-tab navigation)
│   ├── main.tsx                   Entry point
│   ├── types.ts                   TypeScript type definitions
│   ├── index.css                  Global styles + Tailwind v4
│   ├── components/
│   │   ├── FileTreePanel.tsx      File tree browser with search/filter
│   │   ├── ContextPanel.tsx       Context builder (config + build)
│   │   ├── OutputPanel.tsx        View/copy/save generated context
│   │   ├── SettingsPanel.tsx      Ignore patterns, defaults, preferences
│   │   └── AboutPanel.tsx         Version, author, links
│   └── hooks/
│       └── useTauri.ts            Tauri invoke wrappers
├── src-tauri/                    Rust backend (Tauri 2)
│   ├── src/
│   │   ├── lib.rs                22 Tauri commands (bridge)
│   │   ├── main.rs               Entry point
│   │   └── engine/
│   │       ├── context/          ContextBuilder — core orchestrator
│   │       ├── filesystem/       Scanner, ignore rules, content reader
│   │       ├── tokenizer/        tiktoken-rs with 3 encoding types
│   │       ├── git/              git2 + CLI fallback
│   │       ├── settings/         AppSettings struct
│   │       └── mcp/              MCP tool definitions + TCP transport
│   ├── tauri.conf.json           App config (window, bundle, plugins)
│   ├── capabilities/             Permission scopes
│   ├── icons/                    App icons (all sizes)
│   ├── Cargo.toml                Rust dependencies
│   └── build.rs                  Tauri build script
├── package.json                  Node dependencies and scripts
├── vite.config.ts                Vite configuration
└── LICENSE                       Apache 2.0

Security & Privacy

RepoPrompt is a local-first context tool. Period.

  • No cloud — All files are read from and written to your local filesystem.
  • No telemetry — Zero data collection. No analytics. No pings.
  • No accounts — No sign-up, no login, no cloud sync.
  • No network requests — The app never makes an external network call.
  • Local storage — Settings live entirely in %APPDATA%\com.miaailab.reprompt\.
  • Safe file handling — Binary files are detected and skipped. .gitignore is respected by default.

🙏 Acknowledgments

This project is a Windows port and evolution of RepoPrompt CE by @r3m00n. The original macOS app pioneered the context engineering workflow, and this port brings that same philosophy to Windows with a full stack rewrite in Tauri 2 + Rust + React.

Huge thanks to the original author for the inspiration and the excellent design patterns.


🤝 Contributing

Found a bug? Have an idea? Open an issue or send a PR.


📄 License

Apache 2.0 — see LICENSE.


Built with ❤️ by Mia's AI Lab using Tauri 2, React, Tailwind CSS, and Rust.
Inspired by RepoPrompt CE by @r3m00n.

Mia's AI Lab X / Twitter