promptbridge
Type coding requests in your own language. Get a clear English task spec your AI coding agent can execute without guessing.
ภาษาไทย · Changelog · Contributing
Many developers read English fine but don't think in it fast enough to write precise prompts. promptbridge sits between you and your coding agent (Claude Code, Claude Desktop, Cursor, any MCP client):
/spec หน้า login อยากให้ถ้าใส่รหัสผิดหลายครั้งมันล็อคไว้ก่อน
(login page: lock it after too many wrong passwords)
- It asks only what is ambiguous — at most 3 tap-to-answer questions, in your language: how many attempts? lock for how long? per account or per IP?
- It shows a 2–3 line summary in your language plus the English spec: Goal · Context · Requirements · Constraints · Acceptance criteria · Assumptions.
- You approve, and the agent does the work — reporting back in your language, with code, paths and errors left untouched.
It also learns your vocabulary: tell it once that «ตะกร้า» means CartStore, and every future spec uses the real name.
How it works
| Part | Does |
|---|---|
| Host model (the Claude/LLM you already use) | Reads your language, fills spec slots in English, asks the questions, summarizes results |
| promptbridge MCP server (Python) | Task templates, decides which questions matter, renders the spec deterministically, remembers your glossary and specs that worked |
The server never calls an LLM itself — no extra API cost, no data leaves your machine. Everything is stored locally in ~/.promptbridge/.
Install
You need uv.
Claude Code
# 1) Register the MCP server for all projects
claude mcp add promptbridge -s user -- uvx promptbridge-mcp
# 2) Install the /spec skill
mkdir -p ~/.claude/skills/spec
curl -fsSL https://raw.githubusercontent.com/Endistic/promptbridge/main/skills/spec/SKILL.md \
-o ~/.claude/skills/spec/SKILL.md
# 3) In any project
/spec ปุ่มบันทึกในหน้าโปรไฟล์กดแล้วขึ้น error 500
Claude Desktop
Claude menu (macOS menu bar) → Settings… → Developer → Edit Config, add the server, then quit (⌘Q) and reopen:
{
"mcpServers": {
"promptbridge": { "command": "/opt/homebrew/bin/uvx", "args": ["promptbridge-mcp"] }
}
}
Use the full path from which uvx — Claude Desktop does not see your shell's PATH. Then ask: "Use promptbridge to make a spec for: …"
Cursor and other MCP clients
{ "mcpServers": { "promptbridge": { "command": "uvx", "args": ["promptbridge-mcp"] } } }
Clients without the skill follow the workflow described in the tools themselves.
From source
git clone https://github.com/Endistic/promptbridge
claude mcp add promptbridge -s user -- uvx --from ./promptbridge promptbridge
Or load it as a Claude Code plugin (server + skill): claude --plugin-dir ./promptbridge, then /promptbridge:spec.
Usage
| Type | Result |
|---|---|
/spec <request> |
Full flow: ask → summarize → do |
/spec --quick <request> |
Skip questions; unknowns become visible Assumptions in the spec |
| "remember: ตะกร้า = CartStore" | Add a glossary term |
| "show my glossary" | List glossary terms |
| "have I asked for something like this before?" | Search specs that worked |
Task types
bug_fix · feature · refactor · test · explain — each has its own required facts (src/promptbridge/templates/). Adding a type is one YAML file.
Glossary
- personal —
~/.promptbridge/pb.db, follows you across projects - repo —
<repo>/.promptbridge/glossary.yaml, commit it so the whole team shares one vocabulary
When you edit a spec and add a real name (e.g. LoginAttemptService), promptbridge offers to remember the pairing.
Languages
Hand-written question phrasing ships for 11 locales. Pass the code as locale (case and _/- don't matter; en-UK, jp, kr, zh-Hans are understood).
| Language | locale |
Notes |
|---|---|---|
| Thai | th |
|
| English | en, en-US |
|
| English (UK) | en-GB |
British spelling, day-month-year dates |
| English (Australia) | en-AU |
Australian spelling, day-month-year dates |
| Japanese | ja |
polite です/ます |
| Mandarin Chinese (Simplified) | zh, zh-CN |
|
| Spanish | es (es-MX, es-ES, …) |
neutral, informal tú |
| Russian | ru |
polite вы |
| Arabic | ar |
Modern Standard Arabic |
| French | fr (fr-CA, …) |
vous, French punctuation spacing |
| Korean | ko |
polite 해요체 |
Any other language (Vietnamese, Indonesian, German, Traditional Chinese zh-TW, …) still works: promptbridge uses English phrasing and tells the host model to ask and reply in that language. Task types are guessed from keywords in all 11 languages. Adding a language is one YAML file — see CONTRIBUTING.md.
MCP tools
| Tool | Purpose |
|---|---|
pb_capture |
Start from the user's raw request: guess task type, match glossary, scan the repo |
pb_clarify |
Decide which questions to ask (max 3 per round, max 2 rounds) |
pb_compile |
Render the English spec; unconfirmed guesses become Assumptions |
pb_save |
Record accepted / edited / rejected; suggest glossary terms from edits |
pb_glossary |
List / add / remove terms (personal or repo scope) |
pb_library |
Search specs that worked before |
Resource promptbridge://stats reports accepted / edited / rejected counts.
Configuration
| Variable | Default | Meaning |
|---|---|---|
PROMPTBRIDGE_HOME |
~/.promptbridge |
Where the local database lives |
Works with MCP Python SDK 1.x and 2.x.
License
Metadata
Release files for promptbridge-mcp 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| promptbridge_mcp-0.3.0.tar.gz | 44.9 kB | With provenance | Details for promptbridge_mcp-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| promptbridge_mcp-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for promptbridge_mcp-0.3.0-py3-none-any.whl |
Total release size: 87.8 kB
Release files / promptbridge_mcp-0.3.0.tar.gz
| Download URL | promptbridge_mcp-0.3.0.tar.gz |
|---|---|
| Size | 44.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bfd818c17fa4c951f81ace02d2120663b8a83d73cc493d159ba8c627597ac91b
|
|
BLAKE2b-256 checksum How to use checksums |
a9e9e12e0b20f1e4e3543299951d8f4c1c3daabaa93a70954465d28b985a93f8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / promptbridge_mcp-0.3.0-py3-none-any.whl
| Download URL | promptbridge_mcp-0.3.0-py3-none-any.whl |
|---|---|
| Size | 42.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a5ff3e4919766128f3ea718ad55383bd9d36dc01a19fe42cb84665c3cc69f073
|
|
BLAKE2b-256 checksum How to use checksums |
1ab33e23f9f0484eecb7a9a339787722c9769e1d543e42fb43f3d247a4d76dc3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logSecurity for promptbridge-mcp 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for promptbridge_mcp-0.3.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.