English | 中文

FradSer/dotagent is a cross-assistant workflow marketplace that bundles five opinionated packs covering code review, Git automation, GitHub operations, SwiftUI architecture reviews, and developer utilities. All commands/agents originate from the canonical YAML under prompts/ and are transformed into Claude/Cursor/Codex/Gemini deliverables via pnpm build:prompts, which also regenerates .claude-plugin/marketplace.json.

/plugin marketplace add FradSer/dotagent

# Browse marketplace and install from the UI picker
/plugin

# Or install plugins directly when you know the slug
/plugin install review@fradser-dotagent
/plugin install git@fradser-dotagent
/plugin install github@fradser-dotagent
/plugin install swift@fradser-dotagent
/plugin install utils@fradser-dotagent

cd path/to/this/repo

cp -r dist/cursor/ $HOME/.cursor

cd path/to/this/repo

cp -r dist/codex/ $HOME/.codex

cd path/to/this/repo

cp -r dist/gemini/ $HOME/.gemini

Multi-agent review system for enforcing high quality.

• Agents: @code-reviewer, @security-reviewer, @tech-lead-reviewer, @ux-reviewer, @code-simplifier
• Slash commands: /hierarchical, /quick, /refactor
• Use it for: full-stack audits, security reviews, architectural guidance, guided refactors

Conventional Git and GitFlow automation.

• Slash commands: /commit, /push, /commit-and-push, /gitignore
• GitFlow helpers: /start-feature, /finish-feature, /start-release, /finish-release, /start-hotfix, /finish-hotfix
• Use it for: atomic commits, branch discipline, automated .gitignore generation

GitHub project operations with quality gates.

• Slash commands: /create-issues, /create-pr, /resolve-issues
• Highlights: worktree-based issue resolution, automated label management, security and quality validation before PRs ship

Dedicated SwiftUI Clean Architecture reviewer.

• Agent: @swiftui-clean-architecture-reviewer
• Use it for: enforcing MVVM + Clean Architecture layering, SwiftData integration reviews, platform compliance checks

Utility commands for day-to-day automation.

• Slash commands: /continue, /create-command
• Use it for: resuming stalled sessions, scaffolding new custom slash commands

Separate utility for syncing your global CLAUDE.md configuration file.

The sync-to-github.sh script synchronizes your CLAUDE.md file between $HOME/.claude and this GitHub repository. This is independent of the plugin installation above.

Run locally (if you've cloned this repo):

bash sync-to-github.sh

Run remotely (one-liner):

bash <(curl -fsSL https://raw.githubusercontent.com/FradSer/dotagent/main/sync-to-github.sh)

sync-to-github.sh [options]

Options:
  -y, --yes, --non-interactive   Run without prompts; requires --prefer
      --prefer <local|repo>      Choose source of truth when differences are found (default: repo)
      --branch <name>            Override target branch (default: main)
      --exclude <pattern>        Add extra exclude pattern (can be repeated)
      --https                    Clone via HTTPS instead of SSH
  -h, --help                     Show this help

Non-interactive mode (prefer local changes):

bash <(curl -fsSL https://raw.githubusercontent.com/FradSer/dotagent/main/sync-to-github.sh) --yes --prefer local

Non-interactive mode (prefer repository version):

bash sync-to-github.sh --yes --prefer repo

Interactive mode (prompts for choices):

bash sync-to-github.sh

dotagent/
├── .claude-plugin/              # Claude marketplace manifest (auto-generated)
├── dist/                        # Generated outputs for each assistant
│   ├── claude/plugins/...       # Claude marketplace bundles
│   ├── cursor/commands/...      # Cursor command palette entries
│   ├── codex/prompts/...        # Copilot reference prompts
│   └── gemini/commands/...      # Gemini command TOML files
├── prompts/                     # Canonical cross-assistant definitions
│   ├── <plugin>/plugin.yaml
│   ├── <plugin>/commands/*.yaml
│   └── <plugin>/agents/*.yaml
├── config/platforms/*.yaml      # Platform output requirements
├── docs/                        # Integration guides (Claude, Cursor, Codex, Gemini)
├── scripts/build/index.mjs      # Multi-platform generator (pnpm build:prompts)
└── archive/                     # Archived legacy Claude plugin sources

See CLAUDE.md for the full development playbook that inspired these workflows, including mandatory TDD, Clean Architecture guardrails, and tooling conventions. Check docs/ for platform-specific usage guides.

• How do I update plugins? Use /plugin update review@fradser-dotagent (replace name as needed) or reinstall.
• Can I fork and customize? Yes. Fork the repo, adjust plugin content, update .claude-plugin/marketplace.json, and point your team to your fork.
• Can I install a subset? Absolutely. Each plugin is independent—install only what fits your workflow.
• Do I need all agents for reviews? The review plugin bundles agents so you can selectively call the specialist you need.

MIT License – see LICENSE for details.