1 unstable release

0.34.0 Oct 25, 2024

#2561 in Command line utilities

MIT license

105KB
2.5K SLoC

nk

configuration management for developers

install

  • Install nk

    curl -fsSL https://raw.githubusercontent.com/ciiqr/nk/HEAD/install.sh | bash
    
  • Add to path

    append to your ~/.zprofile or ~/.bash_profile/~/.bashrc to make this permanent

    export PATH="${HOME}/.nk/bin:${PATH}"
    

install (windows)

  • Install nk (via powershell)

    Set-ExecutionPolicy Bypass -Scope Process -Force
    Invoke-Expression ((New-Object System.Net.WebClient).DownloadString(
        'https://raw.githubusercontent.com/ciiqr/nk/HEAD/install.ps1'
    ))
    
  • Add to path

    for current session only, install script already updated user path which will be used for new sessions

    $env:Path = "${HOME}/.nk/bin" + [IO.Path]::PathSeparator + $env:Path
    

setup

  • Create nk config ./.nk.yml

    sources:
      - .
    plugins:
      - ciiqr/nk-plugins
    
  • Create state config ie. config.yml (any *.yml except dotfiles .*.yml)

    when: os == "macos"
    
    packages:
      - homebrew/cask/google-chrome
    
  • Provision state

    nk provision
    

local development

  • install dependencies and configure hooks (macos only atm, read script to figure out commands for other platforms)
./bin/dev setup

resources

Dependencies

~33–52MB
~1M SLoC