Boilerplate

boilerplate

Shared Codex and Claude Code defaults for macOS and Windows.

The setup keeps task-completion responses short, direct, and easy to read for people who use English as a second language. It does not copy authentication, tokens, project trust, or other machine-specific state.

Install on macOS

Install and authenticate GitHub CLI, then run:

mkdir -p ~/projects
gh repo clone lucas-lucena-lab/boilerplate ~/projects/boilerplate
~/projects/boilerplate/install.sh

Start new Codex and Claude sessions after installation.

Install on Windows

Open PowerShell, install and authenticate GitHub CLI, then run:

New-Item -ItemType Directory -Force -Path "$HOME\projects" | Out-Null
gh repo clone lucas-lucena-lab/boilerplate "$HOME\projects\boilerplate"
powershell.exe -NoProfile -ExecutionPolicy Bypass `
  -File "$HOME\projects\boilerplate\install.ps1"

`ExecutionPolicy Bypass` applies only to that PowerShell process. It does not change the system execution policy.

What is installed

• codex/AGENTS.md is installed as ~/.codex/AGENTS.md.
• The Codex verbosity and personality defaults are merged into ~/.codex/config.toml.
• claude/CLAUDE.md is installed as ~/.claude/CLAUDE.md.
• The custom Claude output style is installed under ~/.claude/output-styles/ and selected in ~/.claude/settings.json.

Existing instruction files are backed up before they are replaced. Existing Codex and Claude settings are preserved; the installer changes only the keys tracked in this repository. The macOS installer uses symbolic links for the instruction files. The Windows installer copies them, so it works without Administrator access or Developer Mode.

Update an existing machine

git -C ~/projects/boilerplate pull --ff-only
~/projects/boilerplate/install.sh

On Windows:

git -C "$HOME\projects\boilerplate" pull --ff-only
powershell.exe -NoProfile -ExecutionPolicy Bypass `
  -File "$HOME\projects\boilerplate