vip

vip is the CLI for scaffolding very important projects, creating and configuring GitHub repositories, and applying team standards such as rulesets, secrets, and environments.

Features

• Project templates: Generate projects from templates (Go, TypeScript, Rust, and more)
• GitHub integration: Create and configure repositories (personal or organization)
• Team configurations: Apply environments, rulesets, and secrets
• Secrets management: Store secret values in the system keyring
• Extensible architecture: Add new templates and project types

Quick Start

Authentication

First, authenticate with GitHub:

vip auth login

This opens your browser for GitHub device authentication and stores the token in your system keyring.

Create a New Project

# Create a new Go service
vip project create my-service --language go --type service --team platform

# Create a TypeScript service
vip project create my-lib --language typescript --type service --team frontend

Create a Repository Only

vip repo create my-repo --team platform --description "My awesome repository"

Check Your Authentication Status

vip auth status

Available templates: Go service and Node service. See Templates for details on using custom templates.

Installation

macOS

brew tap nentgroup/viaplay-cli https://github.com/nentgroup/viaplay-cli
brew install --cask nentgroup/viaplay-cli/vip

Linux

You can install vip on Linux in either of these ways:

Option 1: Install via Homebrew (Linuxbrew)

If you have Homebrew on Linux installed:

brew tap nentgroup/viaplay-cli https://github.com/nentgroup/viaplay-cli
brew install --cask nentgroup/viaplay-cli/vip

Option 2: Install from the package manager

Download a package built by GoReleaser from the GitHub Releases page:

# Debian / Ubuntu
sudo dpkg -i vip_*.deb

# RPM-based distros
sudo rpm -i vip_*.rpm

# Alpine / APK-based distros
sudo apk add --allow-untrusted vip_*.apk

Option 3: Install from source or binary

go install github.com/nentgroup/viaplay-cli/cmd/vip@latest

Or download a release binary and place it on your PATH:

chmod +x ./vip
sudo install ./vip /usr/local/bin/vip

Windows

You can install vip on Windows in either of these ways:

Option 1: Install via winget

winget install nentgroup.viaplay-cli

Option 2: Download a release binary

Download the latest vip.exe from the GitHub Releases page, then place it in a folder already on your PATH.

Option 3: Build from source

git clone https://github.com/nentgroup/viaplay-cli.git
cd viaplay-cli
go build -o vip.exe ./cmd/vip
Move-Item .\vip.exe "$env:USERPROFILE\bin\vip.exe"

Cross-platform via Go

go install github.com/nentgroup/viaplay-cli/cmd/vip@latest

This works on macOS, Linux, and Windows when Go is installed and $(go env GOPATH)/bin (or %USERPROFILE%\go\bin) is on your PATH.

Building from Source

When building from source, you must provide the GitHub OAuth client ID used by device auth:

export GITHUB_CLIENT_ID="your-client-id"
go build -o vip ./cmd/vip

On PowerShell:

$env:GITHUB_CLIENT_ID = "your-client-id"
go build -o vip.exe .\cmd\vip

This value is required for vip auth login to work when you are not using a release build that embeds the client ID.

macOS Security Bypass

When installing on macOS by downloading the binary directly, you may encounter security blocks. To bypass these:

chmod +x ./vip
xattr -dr com.apple.quarantine ./vip
sudo mv vip /usr/local/bin/

Documentation

Full documentation is available at nentgroup.github.io/viaplay-cli

Development

Prerequisites

• Go 1.27 or later
• Task (optional, for easier scripts)

Build the CLI

go build -o vip ./cmd/vip

Run the CLI (development)

go run ./cmd/vip --help

Lint & Format

golangci-lint run --fix

Run Tests

go test ./...

Contributing

Contributions are welcome. Please read CONTRIBUTING.md for setup guidance, PR expectations, and contribution standards.

Security

If you discover a security issue, please follow the disclosure process in SECURITY.md. Please do not open a public issue for vulnerabilities.

Code of conduct

Please review the Code of Conduct before participating in the project.

License

This project is licensed under the MIT License.