iannuttall/dotagents

ドットエージェント

すべてのAIツールを動かす標準的な.agentsフォルダが一つあります。

シンプルな設定 • 唯一の真実の情報源 • いつでも安全に再実行できる

クイックスタート

条件:バン1.3+。

ガイド付きCLIを実行してください:

あるいはバンと一緒に:

ワークスペース(グローバルホームまたはプロジェクトフォルダ)を選び、管理したいクライアントを選び、プロンプトに従ってください。リンク修復や変更の元に戻すために、いつでも再度実行できます。

グローバルホームはすべてのプロジェクトに影響します。プロジェクトフォルダは、dotagentを実行している現在のディレクトリにのみ影響します。

それが何をするのか

• .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.