dotfiles

This repository contains my preferred settings for new development environments and some tools to help set them up.

Table of Contents

• dotfiles
  • Table of Contents
  • JSR Packages
    • Platform Support
    • @patdx/pkg
      • Usage
    • @patdx/update
      • Usage
    • @patdx/git-json-merge
      • Usage
  • System
    • git
    • Software to Install
      • Install Git Credential Manager on Linux
      • Installing Binaries on Linux
      • Doing updates on Linux
    • Python
  • Software Projects
    • .editorconfig

JSR Packages

Package	Description
@patdx/pkg	CLI tool for installing and managing binary packages on Linux
@patdx/update	Script for performing system updates and managing installed packages
@patdx/git-json-merge	Git merge driver for automatically resolving JSON/JSONC file conflicts

Platform Support

• ✅ Fedora Linux (primary supported/tested platform)
• ✅ Other Linux distributions (should work)
• ✅ macOS (mostly supported/tested)
• ❌ Windows (not supported but would be open to adding support)

@patdx/pkg

A CLI tool for easily installing and managing binary packages on Linux. It simplifies the process of:

• Installing zipped binaries to ~/.local/bin
• Managing known packages through a simple command interface
• Handling GitHub release assets automatically

Usage

# Install a known package
deno run -A --reload jsr:@patdx/pkg add windsurf

# Install from a specific URL
deno run -A --reload jsr:@patdx/pkg add --url https://github.com/duckdb/duckdb --name duckdb

# List installed packages
deno run -A --reload jsr:@patdx/pkg list

# Remove a package
deno run -A --reload jsr:@patdx/pkg remove duckdb

@patdx/update

A script for performing system updates on Linux that:

• Runs system updates
• Manages installed packages
• Updates Git Credential Manager automatically

Usage

# Use latest version (recommended)
deno run -A --reload jsr:@patdx/update

@patdx/git-json-merge

A Git merge driver that automatically resolves merge conflicts in JSON files. It detects indentation automatically and performs three-way merges, making it easier to handle JSON file conflicts in Git.

Usage

First, install via JSR:

deno add jsr:@patdx/git-json-merge

Configure Git globally by adding to ~/.gitconfig:

[core]
    attributesfile = ~/.gitattributes
[merge "json"]
    name = custom merge driver for json files
    driver = deno run --allow-read --allow-write jsr:@patdx/git-json-merge %A %O %B

Create ~/.gitattributes:

*.json merge=json

Or for a single project, configure locally:

git config merge.json.driver "deno run --allow-read --allow-write jsr:@patdx/git-json-merge %A %O %B"
git config merge.json.name "custom merge driver for json files"

And add the same .gitattributes to your project.

System

git

For git I don't have a config file, I just run the following script to update the global config.

git config --global init.defaultBranch main
git config --global pull.ff only
git config --global rebase.autoStash true
git config --global core.editor "code --wait"
git config --global --type bool push.autoSetupRemote true

Software to Install

• git
• git-lfs
• VS Code
• Git Credential Manager (See next section)

Install Git Credential Manager on Linux

While Git Credential Manager does provide a .deb, they sadly don't provide a .rpm for Fedora users.

I've prepared a simple script to install it on Linux using @patdx/pkg. Install Deno then run:

deno run -A jsr:@patdx/pkg add git-credential-manager

After installation, you may want to configure it to use the freedesktop.org Secret Service API:

git config --global credential.credentialStore secretservice

Installing Binaries on Linux

It can be inconvenient when tools just provide a zipped binary and ask you to install it. The @patdx/pkg CLI tool makes this process much easier by automatically downloading and installing binaries to ~/.local/bin. See the @patdx/pkg documentation above for more usage examples.

Doing updates on Linux

The @patdx/update package provides a script to perform system updates on Linux, including upgrading your git-credential-manager version. See the @patdx/update documentation above for usage instructions.

Python

As I don't use python so much, I think it's nice to use pipx:

https://pipx.pypa.io/stable/

Update: I tried pipx and then I could not install extension aider-chat[browser]. It did not make anything easier.

In order to intall python tool such as aider:

https://aider.chat/docs/install/pipx.html

Software Projects

.editorconfig

While I do like indent of 2 spaces, it makes it a pain to do nested lists in Markdown together with Prettier. Therefore I prefer 4 spaces for Markdown.

root = true

[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

[*.md]
indent_size = 4