Forked from Caarlos0 dotfiles

Installation

Dependencies

First, make sure you have all those things installed:

• git: to clone the repo
• curl: to download some stuff
• tar: to extract downloaded stuff
• fish: the shell
• sudo: some configs may need that

Install

Then, run these steps:

git clone https://github.com/stvmachine/dotfiles_v3 ~/.dotfiles
cd ~/.dotfiles
./script/bootstrap.fish

Mac brew install

Run brew bundle from macos folder

cd macos
brew bundle

All changed files will be backed up with a .backup suffix.

Update

To update, you just need to git pull and run the bootstrap script again:

cd ~/.dotfiles
git pull origin master
./script/bootstrap.fish

Revert

Reverting is not totally automated, but it pretty much consists in removing the fish config and dotfiles folder, as well as moving back some config files.

rm -rf ~/.dotfiles $__fish_config_dir

The bootstrap script would have created a bunch of symlinks that will now be broken. You will have to investigate those manually. In cases a file already existed, the boostrap script should have created a .backup file with the same name.

Recommended Software

All tools below are compatible with Fish shell and Starship prompt:

• bat a cat(1) clone with wings;
• fzf for a fuzzy-finder (with Fish integration);
• gh for more GitHub integration with the terminal;
• grc to colorize command's outputs;
• starship.rs the prompt we are using (Fish is the shell);

OpenCode

This dotfiles repo manages the OpenCode configuration under .config/opencode/. It includes profiles, the rtk.ts plugin, oh-my-opencode-slim presets, and non-GSD skills. GSD-related generated files are ignored.

Install

After running the bootstrap script and brew bundle, set up OpenCode:

cd ~/.dotfiles
./script/bootstrap.fish

cd ~/.config/opencode
npm install

opencode plugin install -g oh-my-opencode-slim
opencode plugin install -g @warp-dot-dev/opencode-warp
opencode plugin install -g opencode-openai-codex-auth

Profiles

OCX profiles launch different oh-my-opencode-slim presets:

ocx opencode -p free
ocx opencode -p kimi
ocx opencode -p kimi-superpowers
ocx opencode -p sol-kimi

See .config/opencode/PROFILES.md for how the profile → preset mapping works.

GSD-core

To install GSD workflows and agents on top of this OpenCode setup:

npx -y @opengsd/gsd-core@latest --opencode --global

GSD writes ignored files into ~/.config/opencode/ (agents, command, gsd-core, hooks, etc.), so they are not tracked in this repo.

Mac Setup

Facing the setup of a new machine (or the need to reinstall after a fresh OS install or the like), here's a very brief and basic list of the usual suspects, related to the setup of a mac computer to work with (mostly related to a scripting languages context).

The package manager is the default first thing I always install. Simply following the default steps. Homebrew should download and install the Command Line Tools for Xcode automatically, but if it doesn't work, you can install them manually:

xcode-select --install

Install brew and install apps

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew bundle --file ~/.dotfiles/macos/Brewfile 

macOS defaults

You use it by running:

~/.dotfiles/macos/set-defaults.sh

And logging out and in again or restart.

Acknowledge

Thanks to alexramirez: https://github.com/alexramirez/mac-setup