README

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

claude-config

Install to Claude Code