gitflic-cli

Оформление

gitflic-cliПолный CLI для REST API GitFlic

Ноль внешних зависимостей. 100% покрытие ~199 эндпоинтов в 20 модулях. MCP-сервер для AI-агентов.

Быстрый старт
Все команды
Покрытие API
gitflic-cli
🧩

100% REST API

Все 20 разделов GitFlic REST — MR, релизы, задачи, ветки/теги, коммиты, файлы, проекты, команды, компании, окружения, вебхуки, реестр пакетов, CI/CD, раннеры, админ, SAML.

🪶

Ноль зависимостей

Чистый Node ESM (≥18) на глобальном fetch. Никакого npm install — один бинарь gitflic.

🤖

Дружелюбен к агентам

--format json + NDJSON streaming + стабильные коды возврата. MCP-сервер (77 тулзов) поверх всего CLI — со сжатием ответов (~70% экономии токенов).

🔐

Безопасные токены

macOS Keychain / Linux libsecret / chmod 0600 fallback. Multi-account и per-project bindings.

📦

Реестр пакетов

list/get/versions/files/delete + upload/download для generic, maven, npm, pypi, nuget, composer, opm, cran, rubygem, cargo, conda.

⚙️

Надёжность

Авто-ретраи на 429/502/503/504, пагинация --all, TUI-браузер MR, 256 self-тестов.

За 30 секунд ​

bash
npm install -g gitflic-cli                       # или разово: npx gitflic-cli help

gitflic auth login --token xxxx-xxxx-xxxx       # валидирует через /user/me, кладёт в Keychain
gitflic mr list --project tikhon/gitflic-cli    # список MR
gitflic mr create --title "Fix login" --to main

Ноль транзитивных зависимостей — чистый Node ESM (>=18), один бинарь gitflic. Другие способы установки →

Архитектура ​

gitflic-cli/
├── bin/gitflic              # bash-шим → node lib/gitflic.mjs
├── lib/
│   ├── gitflic.mjs          # диспетчер команд
│   ├── http.mjs             # fetch + retry + parseArgs + resolveToken + httpText/httpDownload/httpUploadFile
│   ├── secret.mjs           # macOS Keychain / Linux libsecret / chmod 0600
│   ├── config.mjs           # persistent user config (chmod 0600)
│   ├── cache.mjs            # file-based project-UUID cache
│   ├── paginate.mjs         # --all auto-pagination + NDJSON streaming
│   ├── format.mjs           # вывод + цвета (NO_COLOR / FORCE_COLOR) + htmlUnescape
│   ├── tui.mjs              # интерактивный браузер MR
│   └── cmd/                 # модули команд (mr, branch, release, registry, ...)
├── mcp-server/              # Model Context Protocol сервер
└── docs/                    # эта документация (VitePress)

Лицензия ​

MIT.

MIT License

gitflic-cli — неофициальный пользовательский CLI для GitFlic