Agent Config

agent-config

My agent configuration for Claude Code and Codex.

Quick start

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.

Managing your config

Safe operations with backups

All destructive operations create timestamped backups:

Validate skills

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

Testing

Tests use Bats (Bash Automated Testing System).

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:

See also

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