Dotfiles

Personal configuration for AI coding tools and terminal workflows. This repository keeps the source files under dotfiles/ and uses dotfiles.json to link them into the expected locations in $HOME.

Setup

Requires Node.js >=22.12.0.

npm install
npm run link

npm run link reads dotfiles.json and creates or updates the configured links, for example ~/.config/opencode, ~/.codex, ~/.pi/agent, and ~/.agents.

Commands

npm run link              # Link dotfiles into $HOME
npm run check             # Run tests, lint, typecheck, and OpenSpec validation

Structure

.
├── dotfiles.json   # Link manifest: source files and target locations
├── dotfiles/       # Configurations that are linked into $HOME
├── src/            # TypeScript linker implementation
├── scripts/        # Local automation
├── docs/adr/       # Architecture decision records
└── openspec/       # Specs and change proposals