Dotfiles

Prerequisites

• Install git
• Clone this repo

git clone https://github.com/vadimshvetsov/dotfiles.git && cd dotfiles

Installation

Install Ansible. On macOS, use Homebrew.

brew install ansible

On Debian or Ubuntu, use apt.

sudo apt-add-repository ppa:ansible/ansible
sudo apt update
sudo apt install ansible

Install Ansible Galaxy collections, then run bootstrap.

ansible-galaxy collection install -r requirements.yml
ansible-playbook -K ansible/bootstrap.yml

Use -K only when a run reaches privileged tasks and needs a sudo password. -K asks for the sudo/become password. It does not force every task to use sudo.

Run a tagged bootstrap when needed. OpenCode and Claude are intended to be run explicitly by tag. Skills are dependencies of those roles, not a direct bootstrap target. If both consumers are desired, run both tags; skills may run once per consumer and stay idempotent.

ansible-playbook ansible/bootstrap.yml -t opencode
ansible-playbook ansible/bootstrap.yml -t claude
ansible-playbook ansible/bootstrap.yml -t opencode,claude
ansible-playbook -K ansible/bootstrap.yml -t zsh

bootstrap.yml does not currently use Ansible's never opt-in tag.

OpenCode

~/.config/opencode is symlinked from config/opencode via Ansible. Agent files live in config/opencode/agents. Global skills install to ~/.agents/skills. Custom OpenCode skills live in ~/.config/opencode/skills.

npx skills add <skill>