iannuttall/dotagents

도트에이전트

모든 AI 도구를 구동하는 하나의 정식 .agents 폴더가 있습니다.

간단한 설정 • 진실의 한 가지 출처 • 언제든지 안전하게 재운영할 수 있습니다

퀵 스타트

요구 조건: 번 1.3+.

가이드 CLI를 실행하세요:

또는 번과 함께:

작업 공간(글로벌 홈 또는 프로젝트 폴더)을 선택하고, 관리하고 싶은 클라이언트를 선택한 후 프롬프트를 따라 하세요. 언제든지 다시 실행하여 링크를 복구하거나 변경 사항을 되돌릴 수 있습니다.

글로벌 홈은 모든 프로젝트에 영향을 줍니다. 프로젝트 폴더는 현재 dotagents를 실행하는 디렉터리에만 영향을 줍니다.

그것이 하는 일들

• .agents를 진실의 근원으로 남긴다.
• Claude, Codex, Factory, Cursor, OpenCode, Gemini(선택한 것에 따라 )의 심볼링 링크를 생성합니다.
• 변경 사항이 되돌릴 수 있도록 덮어쓰기 전에 항상 백업을 생성합니다.

연결 지점 (전 세계 범위)

.agents/CLAUDE.md → ~/.claude/CLAUDE.md (존재 시)

.agents/AGENTS.md → ~/.claude/CLAUDE.md (CLAUDE.md 없을 때 대기 수단)

.agents/GEMINI.md → ~/.gemini/GEMINI.md (존재 시)

.agents/AGENTS.md → ~/.gemini/GEMINI.md (GEMINI.md 없을 때 대비)

.agents/commands → ~/.claude/commands

.agents/commands → ~/.factory/commands

.agents/commands → ~/.codex/prompts

.agents/commands → '~/.

Quick Start

Requirements: Bun 1.3+.

Run the guided CLI:

npx @iannuttall/dotagents

Or with Bun:

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/skills

.agents/skills → ~/.cursor/skills

.agents/skills → ~/.config/opencode/skills

.agents/skills → ~/.gemini/skills

Project scope links only commands/hooks/skills into the project’s client folders (no AGENTS/CLAUDE/GEMINI rules).

Development

Run the CLI in dev mode:

bun run dev

Type-check:

bun run type-check

Run tests:

bun test

Build the CLI:

bun run build

Notes

• Cursor supports .claude/commands and .claude/skills (global or project). dotagents also links .agents/commands → .cursor/commands and .agents/skills → .cursor/skills.
• OpenCode uses ~/.config/opencode/AGENTS.md and prefers AGENTS.md over CLAUDE.md when both exist.
• Codex prompts always symlink to .agents/commands (canonical source).
• Skills require a valid SKILL.md with name + description frontmatter.
• Claude prompt precedence: if .agents/CLAUDE.md exists, it links to .claude/CLAUDE.md. Otherwise .agents/AGENTS.md is used. After adding or removing .agents/CLAUDE.md, re-run dotagents and apply/repair links to update the symlink. Factory/Codex always link to .agents/AGENTS.md.