Установка

Требования

• Node.js 18+ (используется глобальный fetch, нет runtime-зависимостей).

npm (рекомендуется)

npm install -g gitflic-cli
gitflic help

У CLI нет транзитивных зависимостей — npm i -g ставит только сам пакет. Обновление: npm update -g gitflic-cli. Удаление: npm uninstall -g gitflic-cli.

Без установки — npx

npx gitflic-cli help
npx gitflic-cli mr list --project owner/repo

Homebrew (macOS / Linux) — скоро

Формула готова, tap ещё не опубликован. Когда появится, установка будет такой:

brew install zhimbura/tap/gitflic

А пока используй npm (выше) или установку из исходников (ниже).

Из исходников (SSH-клон + install.sh)

Подходит, если хочешь хакать CLI локально. Нужен SSH-ключ в https://gitflic.ru.

git clone git@gitflic.ru:tikhon/gitflic-cli.git ~/tools/gitflic-cli
cd ~/tools/gitflic-cli
bash install.sh

install.sh сделает:

1. Скопирует CLI в ~/.local/share/gitflic-cli/.
2. Создаст symlink ~/.local/bin/gitflic → bin/gitflic.
3. Подскажет добавить ~/.local/bin в PATH, если его там ещё нет.

Альтернативные способы

Windows / PowerShell

git clone git@gitflic.ru:tikhon/gitflic-cli.git
cd gitflic-cli
powershell -ExecutionPolicy Bypass -File install.ps1

Кастомный префикс установки

bash install.sh --prefix ~/my-tools
# CLI ляжет в ~/my-tools/share/gitflic-cli, symlink в ~/my-tools/bin/gitflic

Только файлы, без symlink

bash install.sh --no-symlink
# Полезно если PATH под контролем (XDG_BIN_HOME, mise, asdf, ...)

Dry-run (без записи на диск)

bash install.sh --dry-run
# Покажет что будет сделано, ничего не записывая.

HTTPS вместо SSH

GITFLIC_TOKEN=xxxxxxxx bash install.sh
# Использует https://gitflic.ru/tikhon/gitflic-cli.git с basic auth.

Удаление

bash uninstall.sh           # Linux/macOS/WSL
powershell -File uninstall.ps1   # Windows

Ручная установка (без install.sh)

git clone git@gitflic.ru:tikhon/gitflic-cli.git ~/tools/gitflic-cli
chmod +x ~/tools/gitflic-cli/bin/gitflic
ln -sf ~/tools/gitflic-cli/bin/gitflic ~/.local/bin/gitflic
export PATH="$HOME/.local/bin:$PATH"   # добавь в ~/.bashrc / ~/.zshrc

Что ставится на диск

~/.local/share/gitflic-cli/    # сам CLI (копия репо)
~/.local/bin/gitflic           # symlink на bin/gitflic

install.sh НЕ модифицирует ~/.bashrc / ~/.zshrc сам — он только подсказывает. Решение о добавлении в PATH — за тобой.

Запуск из исходников (dev-режим)

Если ты форкнул/клонировал и хочешь запустить без установки:

cd ~/tools/gitflic-cli
node lib/gitflic.mjs --help

Все подкоманды работают идентично, путь просто короче.

Обновление

cd ~/tools/gitflic-cli
git pull
bash install.sh

Старая копия в ~/.local/share/gitflic-cli/ будет перезаписана, symlink останется.