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.
Badge for your README
Markdown
[](/listings/manshooo--gf)HTML
<a href="/listings/manshooo--gf"><img src="/api/listings/manshooo--gf/badge.svg" alt="findsafeskills safety rating" /></a>Install
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
- # gf
- CLI `gf` и локальный MCP-сервер `gf-mcp` для работы с запросами на слияние в GitFlic Cloud. Оба написаны на Rust и используют Git из `PATH`.
- ## Установка
- Готовые архивы для Windows x64 и Linux x64 содержат `gf` и `gf-mcp`. На компьютере нужен Git в `PATH`. [Скачать последнюю версию](https://github.com/Manshooo/gf/releases/latest).
- ### Windows x64 · PowerShell
- ```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
- ```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 скачает, соберёт и установит оба бинарника.
- ```sh
- cargo install --locked --git https://github.com/Manshooo/gf.git
- ```
- ## Использование
- Создайте [API-токен в настройках GitFlic](https://docs.gitflic.ru/latest/profile/api_token/). CLI и сервер читают `~/.config/gitflic/api-header`. В файле должна быть одна строка формата `Authorization: token <токен>`. На Windows `~` соответствует домашнему каталогу пользователя (`%USERPROFILE%`). Заголовок отправляется только на `https://api.gitflic.ru`. HTTP-перенаправления отключены.
- Запускайте команды из рабочей копии. Проект определяется по `origin` в формате `git@gitflic.ru:owner/project.git`, `ssh://git@gitflic.ru/owner/project.git` или `https://gitflic.ru/project/owner/project.git`.
- ```text
- gf project check
- gf mr list
- gf mr list --state all --limit 100
- gf mr view 9
- gf mr create
- gf mr create --title "Исправить фильтр" --body "Описание изменений"
- gf mr create --base release --title "Исправить фильтр"
- ```
- `gf mr list` по умолчанию показывает до 30 открытых запросов. Поддерживаются `open`, `closed`, `merged` и `all`. Результаты собираются по страницам GitFlic до достижения лимита или конца списка.
- `gf mr create` использует текущую локальную ветку и ветку проекта по умолчанию. Флаг `--base` задаёт другую целевую ветку. Если открытый MR между этими ветками уже есть, команда выводит его ссылку. Для нового MR локальный `HEAD` должен совпадать с опубликованным коммитом. Исходная ветка сохраняется после слияния.
- При запуске без `--title` в терминале команда предлагает заголовок последнего коммита и запрашивает описание. Для скриптов передайте `--title` и при необходимости `--body`.
- ## MCP-сервер
- Сервер работает через `stdio` и использует тот же файл авторизации, что и CLI. Откройте терминал в рабочей копии GitFlic, с которой должен работать сервер, и задайте пути для своей платформы.
- **Windows · PowerShell**
- ```powershell
- $gfMcp = Join-Path $env:LOCALAPPDATA 'gf\gf-mcp.exe'
- $gfRepo = (Get-Location).Path
- ```
- **Linux · Bash**
- ```bash
- gfMcp="$HOME/.local/bin/gf-mcp"
- gfRepo="$(pwd -P)"
- ```
- После установки из исходников подставьте в `gfMcp` абсолютный путь к бинарнику, установленному Cargo.
- ### Codex
- Выполните в том же терминале. После настройки откройте новый сеанс Codex.
- ```sh
- codex mcp add gitflic -- "$gfMcp" --repo "$gfRepo"
- codex mcp get gitflic
- ```
- [Документация Codex по MCP](https://developers.openai.com/codex/mcp).
- ### Claude Code
- Параметр `--scope local` подключает сервер для текущего проекта. Внутри Claude Code статус подключения доступен через `/mcp`.
- ```sh
- claude mcp add --transport stdio --scope local gitflic -- "$gfMcp" --repo "$gfRepo"
- claude mcp get gitflic
- ```
- [Документация Claude Code по MCP](https://code.claude.com/docs/en/mcp#option-3-add-a-local-stdio-server).
- ### Claude Desktop · Windows
- Откройте **Settings → Developer → Edit Config**. Добавьте запись `gitflic` в `mcpServers`, подставьте абсолютные пути и полностью перезапустите Claude Desktop.
- ```json
- {
- "mcpServers": {
- "gitflic": {
- "command": "C:/Users/USER/AppData/Local/gf/gf-mcp.exe",
- "args": ["--repo", "C:/path/to/gitflic-repository"]
- }
- }
- }
- ```
- [Настройка локальных серверов в Claude Desktop](https://modelcontextprotocol.io/docs/develop/connect-local-servers).
- | Инструмент | Аргументы |
- | --- | --- |
- | `project_check` | Без аргументов |
- | `mr_list` | `state` и `limit` по желанию, максимум 100 записей |
- | `mr_view` | `number` |
- | `mr_create` | `title`, опционально `body` и `base` |
- По умолчанию доступны первые три инструмента. Чтобы разрешить создание MR, добавьте `--allow-write` в конец команды регистрации или массива `args`. `mr_create` использует опубликованный коммит текущей ветки и возвращает ссылку на созданный или существующий открытый MR.
- ## Сборка
- Для сборки требуется Rust с Cargo и нативный C-компилятор для выбранной платформы.
- ```text
- cargo test --locked
- cargo build --locked --release --bins
- ```
- Исполняемые файлы `gf` и `gf-mcp` находятся в `target/release/`. На Windows у них расширение `.exe`. Тесты создания используют временный Git-репозиторий и локальный HTTP-сервер.
- Справочники интерфейса и 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 inFree to use. If it’s helped, pass it on.