iannuttall/dotagents

Registry

Summary

Dotagents is a TypeScript repository that serves as a centralized location for managing hooks, commands, skills, and AGENT/CLAUDE.md files, helping developers organize their AI agent-related configurations and extensions.

Key features

• Centralized management for hooks, commands, and skills
• Structured storage for AGENT/CLAUDE.md files
• TypeScript implementation for type safety
• Open source with community contributions

Use cases

• Organizing AI agent development projects
• Managing Claude Skill configurations
• Sharing reusable agent components
• Standardizing agent project structures

README excerpt

<div align="center"> <strong>dotagents</strong> <br /> <em>One canonical .agents folder that powers all your AI tools.</em> <br /><br /> <em> Simple setup • One source of truth • Safe to re-run anytime </em> </div> ## Quick Start Requirements: Bun 1.3+. Run the guided CLI: ```bash npx @iannuttall/dotagents ``` Or with Bun: ```bash bunx @iannuttall/dotagents ``` Choose a workspace (Global home or Project folder), select the clients you want to manage, and follow the prompts. You can run it again anytime to repair links or undo changes. Global home affects all projects. Project folder only affects the current directory you run dotagents from. ## What it does - Keeps `.agents` as the source of truth. - Creates symlinks for Claude, Codex, Factory, Cursor, OpenCode, and Gemini (based on your selection). - Always creates a backup before any overwrite so changes are reversible. ## Where it links (global scope) `.agents/CLAUDE.md` → `~/.claude/CLAUDE.md` (if present) `.agents/AGENTS.md` → `~/.claude/CLAUDE.md` (fallback when no CLAUDE.md) `.agents/GEMINI.md` → `~/.gemini/GEMINI.md` (if present) `.agents/AGENTS.md` → `~/.gemini/GEMINI.md` (fallback when no GEMINI.md) `.agents/commands` → `~/.claude/commands` `.agents/commands` → `~/.factory/commands` `.agents/commands` → `~/.codex/prompts` `.agents/commands` → `~/.cursor/commands` `.agents/commands` → `~/.config/opencode/commands` `.agents/commands` → `~/.gemini/commands` `.agents/hooks` → `~/.claude/hooks` `.agents/hooks` → `~/.factory/hooks` `.agents/AGENTS.md` → `~/.factory/AGENTS.md` `.agents/AGENTS.md` → `~/.codex/AGENTS.md` `.agents/AGENTS.md` → `~/.config/opencode/AGENTS.md` `.agents/skills` → `~/.claude/skills` `.agents/skills` → `~/.factory/skills` `.agents/skills` → `~/.codex

Topics

No topics yet.