DotFiles

zsh
powershell

Install

linux

curl -fsSL https://get.comtrya.dev | sh
comtrya -d https://github.com/airtonix/dotfiles apply

macos

curl -fsSL https://get.comtrya.dev | sh
comtrya -d https://github.com/airtonix/dotfiles apply

windows

first open powershell as admin and run:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux,VirtualMachinePlatform -All -NoRestart

then reboot. yes stop crying. just do it.

After rebooting, run:

iwr "https://get.comtrya.dev/ps" -UseBasicParsing | iex
comtrya -d https://github.com/airtonix/dotfiles apply

Intermediary Setup

Above would be useful if comtrya was perfect. However you may instead need to install individual parts:

$env:PATH+=";$env:USERPROFILE\.comtrya"
cd C:\Users\zeno.jiricek\AppData\Local\comtrya\manifests\git\githubcomairtonixdotfiles
comtrya apply -m manifest.dot.notated.path.instead.of.slash.notated.paths

Usage

This is mostly a reminder for myself.

dotfiles apply # applies all changes
dotfiles apply zsh # applies only zsh related changes
dotfiles apply powershell # applies only powershell related changes

# with or without commas
dotfiles apply devtools.opencode,windowmanagers.sway # applies only devtools and sway window manager related changes
dotfiles apply devtools.opencode windowmanagers.sway # applies only devtools and sway window manager related changes

Comtrya Quick Reference

CLI Commands

Command	Description
`comtrya apply`	Apply all manifests in current directory
`comtrya -d ./path apply`	Apply manifests from specific directory
`comtrya -d ./ apply -m one,two,three`	Apply specific manifests by name
`comtrya status`	List manifest status
`comtrya contexts`	List available contexts
`comtrya contexts --show-values`	Show context values
`comtrya version`	Print version information
`comtrya help`	Print help information
`comtrya gen-completions`	Auto generate shell completions

YAML Actions in Manifests

binary.github

Download binary from GitHub

- action: binary.github
  name: comtrya                    # binary name locally
  directory: /usr/local/bin        # save location
  repository: comtrya/comtrya      # github repo
  version: v0.8.7                  # version/tag

command.run (alias: cmd.run)

Run arbitrary commands

- action: command.run
  command: echo
  args:
    - "Hello world"
  dir: .                           # working directory (optional)
  privileged: false                # elevate privileges (optional)
  env:                             # scoped env vars (optional)
    VAR_NAME: value

file.copy

Copy file from files directory to destination

- action: file.copy
  from: config_file                # source (under files/)
  to: "{{ user.config_dir }}/app"  # destination
  template: false                  # render with context (optional)
  chmod: 644                       # octal permissions (optional)
  owned_by_user: username          # chown user (optional, needs root)
  owned_by_group: groupname        # chown group (optional, needs root)

file.download

Download file from URL

- action: file.download
  from: https://example.com/file
  to: /tmp/file
  owned_by_user: user              # chown (optional, needs root)
  owned_by_group: group            # chown (optional, needs root)

file.link

Create symlinks

# Single file
- action: file.link
  from: /root/symlink              # symlink location
  to: managed_file                 # what it points to

# Directory walk
- action: file.link
  source: walker
  target: /tmp/walker-123
  walk_dir: true                   # walk directory

file.remove

Remove file

- action: file.remove
  target: /tmp/some-file

file.unarchive

Extract tar.gz archives

- action: file.unarchive
  from: /tmp/archive.tar.gz
  to: /tmp/extracted
  force: true                      # force extraction (optional)

directory.copy

Copy directory

- action: directory.copy
  from: managed_directory          # source (under files/)
  to: /root/location               # destination

package.install

Install packages

# Default provider
- action: package.install
  name: curl

# Multiple packages
- action: package.install
  list:
    - curl
    - wget

# Specific provider
- action: package.install
  name: curl
  provider: pkgin                  # or: brew, apt, pacman, yay, dnf, etc.

# From repository
- action: package.install
  name: blox
  provider: homebrew
  repository: cueblox/tap

# Local file
- action: package.install
  name: /path/to/file.pkg
  file: true

package.repository

Configure package repositories (more docs needed)

- action: package.repository
  provider: apt
  name: repository-name
  url: https://repo.url
  key: key_conte

...

zenobi-us/dotfiles

README