agent-config

My agent configuration for Claude Code and Codex.

Quick start

git clone https://github.com/brianlovin/agent-config.git
cd agent-config
./install.sh

What's included

Settings

• settings.json - Global permissions and preferences
• statusline.sh - Custom statusline showing token usage

Skills

Reusable capabilities that your coding agents can invoke.

Skill	Description
agent-browser	Browser automation for web testing and interaction
favicon	Generate favicons from a source image
knip	Find and remove unused files, dependencies, and exports
rams	Run accessibility and visual design review
reclaude	Refactor CLAUDE.md files for progressive disclosure
simplify	Code simplification specialist
deslop	Remove AI-generated code slop

Managing your config

# See what's synced vs local-only
./sync.sh

# Preview what install would do
./install.sh --dry-run

# Add a local skill to the repo
./sync.sh add skill my-skill
./sync.sh push

# Pull changes on another machine
./sync.sh pull

# Remove a skill from repo (keeps local copy)
./sync.sh remove skill my-skill
./sync.sh push

Safe operations with backups

All destructive operations create timestamped backups:

# List available backups
./sync.sh backups

# Restore from last backup
./sync.sh undo

Validate skills

./sync.sh validate

Skills must have a SKILL.md with frontmatter containing name and description.

Testing

Tests use Bats (Bash Automated Testing System).

# Install bats (one-time)
brew install bats-core

# Run all tests
bats tests/

# Run specific test file
bats tests/install.bats
bats tests/sync.bats
bats tests/validation.bats

Tests run in isolated temp directories and don't affect your actual ~/.claude config. Tests also cover Codex skills syncing in ~/.codex/skills.

Local-only config

Not everything needs to be synced. The install script only creates symlinks for what's in this repo - it won't delete your local-only skills.

Machine-specific permissions accumulate in ~/.claude/settings.local.json (auto-created by Claude, not synced). Codex skills are also linked from this repo into ~/.codex/skills.

Creating your own

Fork this repo and customize! The structure is simple:

agent-config/
├── settings.json      # Claude Code settings
├── statusline.sh      # Optional statusline script
├── skills/            # Skills (subdirectories with SKILL.md)
├── agents/            # Subagent definitions
├── rules/             # Rule files
└── tests/             # Bats tests

See also

• Claude Code docs
• My dotfiles - Shell, git, SSH config