dot-agents

Personal configuration for coding agents.

This repo keeps the durable, reviewable parts of the agent setup in one place: global instructions, declarative settings, portable rules, personal skills, and future hook glue. Runtime state, auth material, histories, caches, and generated artifacts stay out of git.

Layout

• skills/ - submodule for stanfish06/my-skills, the reusable skill vault.
• agents/ - reusable specialist personas imported from production agent packs.
• claude/ - selected files from ~/.claude: global instructions, settings, and the standalone graphify skill, plus optional slash commands under claude/commands/.
• codex/ - selected files from ~/.codex: global instructions, config, default rules, hooks, and the hatch-pet skill.
• pi-agent/ - selected Pi agent config, currently the mypi theme.
• hooks/ - opt-in Claude hook scripts and hook JSON examples.
• scripts/ - reserved for install, refresh, and validation helpers.
• docs/sources.md - notes from the reference repos and the local import.

First Checkout

git submodule update --init --recursive

The skills/ submodule is intentionally separate from the agent-specific config folders. Agent harnesses can symlink or install skills from that vault while this repo also tracks harness configuration around them.

Install

./scripts/install.sh

The installer is symlink-first for agent config. It initializes the skills/ submodule, delegates skill installation to skills/install-skills.sh, then links the selected Claude, Codex, and Pi config into their agent homes. Existing non-matching files are moved aside to timestamped backups.

Preview changes without touching your home directory:

./scripts/install.sh --dry-run

Imported Reference Content

The submodule includes the selected production engineering skills from addyosmani/agent-skills, excluding the duplicate test-driven-development skill because the vault already carries the Superpowers version. The parent repo also keeps Addy's specialist personas, Claude slash commands, and opt-in hooks.

The hooks/ directory also carries the Superpowers session-start bootstrap hook as an opt-in reference. Do not enable both session-start bootstraps at once unless you explicitly want both meta-skill introductions injected into every session.

The Claude and Codex stop-summary hooks from stanfish06/my-configs are included as repo-managed scripts. They send a simple desktop notification by default; set DOT_AGENTS_STOP_SUMMARY_WITH_CLAUDE=1 to let them ask Claude for a short stop summary before notifying.

Refresh From Home

The current import was intentionally narrow. To refresh it, copy only the same source-of-truth files and review the diff before committing:

rsync -a ~/.claude/CLAUDE.md ~/.claude/settings.json ~/.claude/settings.local.json claude/
rsync -a ~/.claude/skills/graphify claude/skills/
rsync -a ~/.codex/config.toml ~/.codex/AGENTS.md codex/
rsync -a ~/.codex/hooks.json codex/
rsync -a ~/.codex/rules/default.rules codex/rules/
rsync -a ~/.codex/skills/hatch-pet codex/skills/
rsync -a ~/.pi/agent/themes/mypi.json pi-agent/themes/

Do not import auth.json, .claude.json, histories, sessions, plugin caches, SQLite state, generated images, browser state, Pi auth/session state, or temporary folders.