dotfiles

中文

Share commands, skills, and global agent instructions across 30+ AI coding agents.

Install

npx github:notdp/.dotfiles install

Interactive installer with two setup modes:

• Create new — start with pre-made skills & commands, pick what you need
• Import existing — clone your own git repository

Uninstall

npx github:notdp/.dotfiles uninstall

Other commands

npx -y github:notdp/.dotfiles status   # check symlink status
npx -y github:notdp/.dotfiles fix      # merge standalone dirs into dotfiles

What it does

Symlinks a single source directory to every agent's config path:

~/.claude/commands   → ~/.dotfiles/commands
~/.codex/prompts     → ~/.dotfiles/commands
~/.factory/commands  → ~/.dotfiles/commands
~/.claude/CLAUDE.md  → ~/.dotfiles/agents/AGENTS.md
~/.codex/AGENTS.md   → ~/.dotfiles/agents/AGENTS.md
~/.factory/AGENTS.md → ~/.dotfiles/agents/AGENTS.md

Edit once, apply everywhere.

Skills

Skills are managed by the standalone skills CLI, not this installer. It pulls skill packages from GitHub into a universal pool and symlinks them into each agent:

npx skills add <github-repo> -g --all   # install a skill package globally to every agent
npx skills ls -g                         # list global skills
npx skills update -g                     # refresh global skills to upstream HEAD

Layout:

~/.agents/skills/<name>/         ← skill content (one dir per skill, fetched from upstream)
~/.claude/skills/<name>          → ~/.agents/skills/<name>
~/.codex/skills/<name>           → ~/.agents/skills/<name>
~/.factory/skills/<name>         → ~/.agents/skills/<name>
~/.dotfiles/skills/.skill-lock.json  ← portable lock file, committed to track versions

Terminal dotfiles (stow)

Plain single-target dotfiles (tmux, ghostty, ...) are managed with GNU stow, kept separate from the agent fanout above.

brew install stow            # one-time
cd ~/.dotfiles && stow -d config -t ~ tmux ghostty

Each package mirrors home:

~/.dotfiles/config/tmux/.tmux.conf                   → ~/.tmux.conf
~/.dotfiles/config/ghostty/.config/ghostty/config    → ~/.config/ghostty/config

Edit the file under ~/.dotfiles/config/... (the home paths are symlinks pointing here), commit, done. stow -d config -t ~ -D <pkg> removes the symlinks.

Supported Agents

33 agents + 6 universal agents. Full list:

AdaL, Amp, Antigravity, Augment, Claude Code, Cline, CodeBuddy, Codex, Command Code, Continue, Crush, Cursor, Droid, Gemini CLI, GitHub Copilot, Goose, iFlow CLI, Junie, Kilo Code, Kimi Code CLI, Kiro CLI, Kode, MCPJam, Mistral Vibe, Mux, Neovate, OpenClaw, OpenCode, OpenHands, Pi, Pochi, Qoder, Qwen Code, Roo Code, Trae, Windsurf, Zencoder

Skills published here

Skill	Description
polish	Strip AI-speak out of PRs, commits, docs, and messages