AI助手配置管理工具

git clone https://github.com/5LV10/damngood.git
cd damngood
pip install -e .

damngood --help

# See which AI tools are installed
damngood client list

# --- MCP Servers ---
damngood import              # pull existing MCP configs into the registry
damngood add filesystem      # add a new server (opens $EDITOR)
damngood sync                # push to all assigned clients

# --- Agent Instructions ---
damngood instructions add coding-style   # write a snippet (opens $EDITOR)
damngood instructions sync               # push to CLAUDE.md, GEMINI.md, etc.

# --- Skills ---
damngood skills add review-pr            # create a skill (opens $EDITOR)
damngood skills sync                     # deploy to ~/.claude/skills/ etc.

{
  "servers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "env": {},
      "clients": ["cursor", "gemini"]
    }
  }
}

damngood list                  # list servers in central registry
damngood add <name>            # add via JSON editor
damngood edit <name>           # edit via JSON editor
damngood remove <name>         # remove from registry
damngood show <name>           # show details
damngood sync                  # push to all assigned clients
damngood import                # import from existing client configs

$ damngood add github
# Editor opens with template — fill in command, args, env, clients
Added server 'github' to central registry

$ damngood sync
  ✓ cursor    →  2 server(s)  (~/.cursor/mcp.json)
  ✓ gemini    →  1 server(s)  (~/.gemini/settings.json)

# My personal notes (not touched by damngood)

<!-- DAMNGOOD:START -->
<!-- Managed by damngood. Run 'damngood instructions sync' to update. -->

Always prefer TypeScript over JavaScript.
Use conventional commits for all commit messages.

<!-- DAMNGOOD:END -->

More personal notes (also untouched)

$ damngood instructions add coding-style

---
description: "Brief description of this instruction snippet"
clients: [claude, gemini, cursor, windsurf, opencode, continue]
enabled: true
---

Write your instruction content here in plain Markdown.

damngood instructions list              # list all snippets
damngood instructions add <name>        # add snippet (opens editor)
damngood instructions edit <name>       # edit snippet
damngood instructions remove <name>     # remove from registry
damngood instructions show <name>       # show content and metadata
damngood instructions sync              # push to all assigned clients

$ damngood skills add review-pr

---
description: "What this skill does"
user-invocable: true
allowed-tools: [Read, Grep, Bash]
clients: [claude, opencode]
enabled: true
---

# review-pr

Review a pull request for correctness, style, and potential issues.

## Steps

1. Read the diff with `git diff`
2. Check for security issues
3. Summarize findings

damngood skills list              # list all skills
damngood skills add <name>        # add skill (opens editor)
damngood skills edit <name>       # edit skill
damngood skills remove <name>     # remove from registry + delete SKILL.md files
damngood skills show <name>       # show content and metadata
damngood skills sync              # deploy to all assigned clients

damngood client list                    # show all discovered clients and their status
damngood client enable <name>           # include client in all syncs
damngood client disable <name>          # exclude client from syncs
damngood client register <name> --path <path>   # add a custom MCP tool
damngood client remove <name>           # remove a custom registration

~/.damngood/
  registry.json              MCP server registry
  clients.json               Registered AI tool clients
  instructions/
    index.json               Snippet metadata and client assignments
    <name>.md                Snippet content (one file per snippet)
  skills/
    index.json               Skill metadata and client assignments
    <name>/
      content.md             Skill body