Skip to content
Back to search

gf

GitFlic Cloud CLI and MCP server for merge requests

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/manshooo--gf/badge.svg)](/listings/manshooo--gf)

HTML

<a href="/listings/manshooo--gf"><img src="/api/listings/manshooo--gf/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Готовые архивы для Windows x64 и Linux x64 содержат `gf` и `gf-mcp`. На компьютере нужен Git в `PATH`. [Скачать последнюю версию](https://github.com/Manshooo/gf/releases/latest).

Windows x64 · PowerShell

$gfInstall = Join-Path $env:LOCALAPPDATA 'gf'
$gfArchive = Join-Path ([IO.Path]::GetTempPath()) 'gf-windows-x86_64.zip'
Invoke-WebRequest -UseBasicParsing -Uri 'https://github.com/Manshooo/gf/releases/latest/download/gf-windows-x86_64.zip' -OutFile $gfArchive
Expand-Archive -LiteralPath $gfArchive -DestinationPath $gfInstall -Force
& (Join-Path $gfInstall 'gf.exe') --version

Чтобы вызывать `gf` по имени, добавьте `%LOCALAPPDATA%\gf` в пользовательский `PATH` и откройте новый терминал.

Linux x64 · Bash

(
  set -e
  mkdir -p "$HOME/.local/bin"
  gf_archive="$(mktemp)"
  trap 'rm -f -- "$gf_archive"' EXIT
  curl -fsSL 'https://github.com/Manshooo/gf/releases/latest/download/gf-linux-x86_64.tar.gz' -o "$gf_archive"
  tar -xzf "$gf_archive" -C "$HOME/.local/bin"
  "$HOME/.local/bin/gf" --version
)

Чтобы вызывать `gf` по имени, добавьте `$HOME/.local/bin` в `PATH`, если каталог ещё не входит в него.

Из исходников

Если уже установлены Rust и нативный C-компилятор, Cargo скачает, соберёт и установит оба бинарника.

cargo install --locked --git https://github.com/Manshooo/gf.git

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 148 lines
  1. # gf
  2. CLI `gf` и локальный MCP-сервер `gf-mcp` для работы с запросами на слияние в GitFlic Cloud. Оба написаны на Rust и используют Git из `PATH`.
  3. ## Установка
  4. Готовые архивы для Windows x64 и Linux x64 содержат `gf` и `gf-mcp`. На компьютере нужен Git в `PATH`. [Скачать последнюю версию](https://github.com/Manshooo/gf/releases/latest).
  5. ### Windows x64 · PowerShell
  6. ```powershell
  7. $gfInstall = Join-Path $env:LOCALAPPDATA 'gf'
  8. $gfArchive = Join-Path ([IO.Path]::GetTempPath()) 'gf-windows-x86_64.zip'
  9. Invoke-WebRequest -UseBasicParsing -Uri 'https://github.com/Manshooo/gf/releases/latest/download/gf-windows-x86_64.zip' -OutFile $gfArchive
  10. Expand-Archive -LiteralPath $gfArchive -DestinationPath $gfInstall -Force
  11. & (Join-Path $gfInstall 'gf.exe') --version
  12. ```
  13. Чтобы вызывать `gf` по имени, добавьте `%LOCALAPPDATA%\gf` в пользовательский `PATH` и откройте новый терминал.
  14. ### Linux x64 · Bash
  15. ```bash
  16. (
  17. set -e
  18. mkdir -p "$HOME/.local/bin"
  19. gf_archive="$(mktemp)"
  20. trap 'rm -f -- "$gf_archive"' EXIT
  21. curl -fsSL 'https://github.com/Manshooo/gf/releases/latest/download/gf-linux-x86_64.tar.gz' -o "$gf_archive"
  22. tar -xzf "$gf_archive" -C "$HOME/.local/bin"
  23. "$HOME/.local/bin/gf" --version
  24. )
  25. ```
  26. Чтобы вызывать `gf` по имени, добавьте `$HOME/.local/bin` в `PATH`, если каталог ещё не входит в него.
  27. ### Из исходников
  28. Если уже установлены Rust и нативный C-компилятор, Cargo скачает, соберёт и установит оба бинарника.
  29. ```sh
  30. cargo install --locked --git https://github.com/Manshooo/gf.git
  31. ```
  32. ## Использование
  33. Создайте [API-токен в настройках GitFlic](https://docs.gitflic.ru/latest/profile/api_token/). CLI и сервер читают `~/.config/gitflic/api-header`. В файле должна быть одна строка формата `Authorization: token <токен>`. На Windows `~` соответствует домашнему каталогу пользователя (`%USERPROFILE%`). Заголовок отправляется только на `https://api.gitflic.ru`. HTTP-перенаправления отключены.
  34. Запускайте команды из рабочей копии. Проект определяется по `origin` в формате `git@gitflic.ru:owner/project.git`, `ssh://git@gitflic.ru/owner/project.git` или `https://gitflic.ru/project/owner/project.git`.
  35. ```text
  36. gf project check
  37. gf mr list
  38. gf mr list --state all --limit 100
  39. gf mr view 9
  40. gf mr create
  41. gf mr create --title "Исправить фильтр" --body "Описание изменений"
  42. gf mr create --base release --title "Исправить фильтр"
  43. ```
  44. `gf mr list` по умолчанию показывает до 30 открытых запросов. Поддерживаются `open`, `closed`, `merged` и `all`. Результаты собираются по страницам GitFlic до достижения лимита или конца списка.
  45. `gf mr create` использует текущую локальную ветку и ветку проекта по умолчанию. Флаг `--base` задаёт другую целевую ветку. Если открытый MR между этими ветками уже есть, команда выводит его ссылку. Для нового MR локальный `HEAD` должен совпадать с опубликованным коммитом. Исходная ветка сохраняется после слияния.
  46. При запуске без `--title` в терминале команда предлагает заголовок последнего коммита и запрашивает описание. Для скриптов передайте `--title` и при необходимости `--body`.
  47. ## MCP-сервер
  48. Сервер работает через `stdio` и использует тот же файл авторизации, что и CLI. Откройте терминал в рабочей копии GitFlic, с которой должен работать сервер, и задайте пути для своей платформы.
  49. **Windows · PowerShell**
  50. ```powershell
  51. $gfMcp = Join-Path $env:LOCALAPPDATA 'gf\gf-mcp.exe'
  52. $gfRepo = (Get-Location).Path
  53. ```
  54. **Linux · Bash**
  55. ```bash
  56. gfMcp="$HOME/.local/bin/gf-mcp"
  57. gfRepo="$(pwd -P)"
  58. ```
  59. После установки из исходников подставьте в `gfMcp` абсолютный путь к бинарнику, установленному Cargo.
  60. ### Codex
  61. Выполните в том же терминале. После настройки откройте новый сеанс Codex.
  62. ```sh
  63. codex mcp add gitflic -- "$gfMcp" --repo "$gfRepo"
  64. codex mcp get gitflic
  65. ```
  66. [Документация Codex по MCP](https://developers.openai.com/codex/mcp).
  67. ### Claude Code
  68. Параметр `--scope local` подключает сервер для текущего проекта. Внутри Claude Code статус подключения доступен через `/mcp`.
  69. ```sh
  70. claude mcp add --transport stdio --scope local gitflic -- "$gfMcp" --repo "$gfRepo"
  71. claude mcp get gitflic
  72. ```
  73. [Документация Claude Code по MCP](https://code.claude.com/docs/en/mcp#option-3-add-a-local-stdio-server).
  74. ### Claude Desktop · Windows
  75. Откройте **Settings → Developer → Edit Config**. Добавьте запись `gitflic` в `mcpServers`, подставьте абсолютные пути и полностью перезапустите Claude Desktop.
  76. ```json
  77. {
  78. "mcpServers": {
  79. "gitflic": {
  80. "command": "C:/Users/USER/AppData/Local/gf/gf-mcp.exe",
  81. "args": ["--repo", "C:/path/to/gitflic-repository"]
  82. }
  83. }
  84. }
  85. ```
  86. [Настройка локальных серверов в Claude Desktop](https://modelcontextprotocol.io/docs/develop/connect-local-servers).
  87. | Инструмент | Аргументы |
  88. | --- | --- |
  89. | `project_check` | Без аргументов |
  90. | `mr_list` | `state` и `limit` по желанию, максимум 100 записей |
  91. | `mr_view` | `number` |
  92. | `mr_create` | `title`, опционально `body` и `base` |
  93. По умолчанию доступны первые три инструмента. Чтобы разрешить создание MR, добавьте `--allow-write` в конец команды регистрации или массива `args`. `mr_create` использует опубликованный коммит текущей ветки и возвращает ссылку на созданный или существующий открытый MR.
  94. ## Сборка
  95. Для сборки требуется Rust с Cargo и нативный C-компилятор для выбранной платформы.
  96. ```text
  97. cargo test --locked
  98. cargo build --locked --release --bins
  99. ```
  100. Исполняемые файлы `gf` и `gf-mcp` находятся в `target/release/`. На Windows у них расширение `.exe`. Тесты создания используют временный Git-репозиторий и локальный HTTP-сервер.
  101. Справочники интерфейса и API — [GitFlic Cloud REST API](https://docs.gitflic.ru/latest/api/intro/), [методы запросов на слияние](https://docs.gitflic.ru/latest/api/mergeRequest/), [GitHub CLI `gh pr`](https://cli.github.com/manual/gh_pr), [MCP Rust SDK](https://github.com/modelcontextprotocol/rust-sdk).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.