# PromptBranch

Локальное хранилище и версионирование промптов прямо на компьютере. MCP-сервер даёт ИИ-агентам доступ к базе шаблонов без риска перезаписи без вашего ведома.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: PromptBranch
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/PromptBranch/promptbranch
- Обновлён: 2026-10-16
- HTML: https://affpapa.org/nevibecode/mcp/promptbranch

## Что делает

Сервер связывает ассистента с локальной базой данных `library.db` на SQLite. Этот же файл используют десктопное приложение и консольная утилита. Через MCP модель может искать готовые инструкции по заголовкам, считывать текст нужного шаблона и сохранять логи проверок с оценками.

В системе заложено чёткое разделение прав: агент умеет только предлагать правки. Вызов `suggest_variation` не меняет рабочий текст, а создаёт скрытый черновик со статусом ожидания. Повредить рабочий промпт ассистент не сможет физически. Утверждать или отклонять изменения нужно вручную через окно программы.

Файл библиотеки хранится локально на диске, а путь к нему можно переопределить через переменную `PROMPTBRANCH_DB`. Для запуска сервера требуется среда Node.js и штатная утилита `npx`.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add promptbranch -- npx -y @promptbranch/mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add promptbranch -- npx -y @promptbranch/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "promptbranch": {
            "command": "npx",
            "args": [
                "-y",
                "@promptbranch/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "promptbranch": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@promptbranch/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add promptbranch npx -y @promptbranch/mcp
```

## Когда брать
- найти проверенный системный промпт по названию или части текста
- зафиксировать результаты прогона модели и прикрепить заметки к шаблону
- предложить новую вариацию инструкции без риска сломать оригинал
- хранить историю изменений промптов на собственном компьютере

## Примеры запросов агенту
- Найди в PromptBranch шаблон для аудита безопасности и покажи его содержимое.
- Запиши результат теста промпта security-audit в базу PromptBranch с оценкой 4.
- Предложи изменённую версию промпта для ревью кода с пояснением правок.

## Похожие
- [agentic-jujutsu](https://affpapa.org/nevibecode/skills/agentic-jujutsu.md) — скилл · 1200 установок
- [git-notes](https://affpapa.org/nevibecode/skills/git-notes.md) — скилл · 1100 установок
- [git-workflow](https://affpapa.org/nevibecode/skills/bobmatnyc-git-workflow.md) — скилл · 556 установок
- [here-be-git](https://affpapa.org/nevibecode/skills/here-be-git.md) — скилл · 527 установок
- [spatie-version-control](https://affpapa.org/nevibecode/skills/spatie-version-control.md) — скилл · 480 установок
- [git-rebase](https://affpapa.org/nevibecode/skills/git-rebase.md) — скилл · 376 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md