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_content

file.chown

Change file ownership

- action: file.chown
  path: ./files/some-file
  user: username
  group: groupname

Context Variables Available

Use {{ variable_name }} in templates and file.copy actions.

Environment Variables

All env vars accessible via {{ env.VAR_NAME }}

HOME, PATH, SHELL, USER, etc.

OS Context

{{ os.name }}                 # OS name
{{ os.family }}               # OS family
{{ os.version }}              # OS version
{{ os.codename }}             # OS codename
{{ os.edition }}              # OS edition
{{ os.bitness }}              # 32 or 64
{{ os.hostname }}             # System hostname

User Context

{{ user.name }}               # User display name
{{ user.username }}           # Username
{{ user.home_dir }}           # Home directory
{{ user.config_dir }}         # Config directory
{{ user.data_dir }}           # Data directory
{{ user.data_local_dir }}     # Local data directory
{{ user.document_dir }}       # Documents directory
{{ user.id }}                 # User ID

Resolved values by platform:

Variable	Linux	macOS	Windows
home_dir	/home/username	/Users/username	C:\Users\username
config_dir	/home/username/.config	/Users/username/Library/Application Support	C:\Users\username\AppData\Roaming
data_dir	/home/username/.local/share	/Users/username/Library/Application Support	C:\Users\username\AppData\Roaming
data_local_dir	/home/username/.local/share	/Users/username/Library/Application Support	C:\Users\username\AppData\Local
document_dir	unknown	/Users/username/Documents	C:\Users\username\Documents
name	user display name	user display name	user display name
username	username	username	username
id	uid (e.g. 1000)	uid	N/A

Use comtrya contexts --show-values to see resolved values on your system.

Custom Variables

Define in manifest or include via include_variables directive

Supported Package Providers

Provider	OS
pacman/yay	Arch
paru	Arch
apt	Debian/Ubuntu
pkg	FreeBSD
pkgin	NetBSD (Multiple)
brew	macOS
winget	Windows
xbps	Void Linux
zypper	OpenSUSE
macports	macOS
dnf	Fedora
snapcraft	Linux

Key Tips

• Manifest files must be YAML or TOML format
• File references in file.copy, file.link, directory.copy must be under a files/ directory
• Use {{ variable }} for templating in file.copy with template: true
• Template support works with file.download as well
• Privilege escalation available via privileged: true in command.run
• Scoped environment variables in command.run are injected before execution and removed after
• View all available contexts with: comtrya contexts --show-values