Skip to main content
plugin CX Codex

aidd-vcs — Claude Code plugin: what it does, how to install

The aidd-vcs plugin for Claude Code automates Git repository setup, atomic commits, pull requests, release tagging, and conflict handling.

MIT ★ 571 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-vcs@aidd-framework
Open on GitHub

What aidd-vcs does

The plugin handles version control operations within the AI-Driven Development framework. It guides the full lifecycle from repository setup with a default branch and CONTRIBUTING.md to semantic version tagging and tracking tickets.

It packages six distinct skills along with bundled templates in each skill's assets/ folder. During commit operations, it retries scoped hook fixes safely. Conflict resolution explicitly targets deterministic cases or user-approved choices, so ambiguous merge blocks still require manual confirmation.

What it helps with

  • initialize a git repository with default branch and CONTRIBUTING.md
  • record atomic commits with scoped hook retry handling
  • open GitHub pull requests or GitLab merge requests using structured templates
  • generate and push semantic version release tags with notes
  • resolve deterministic merge conflicts when Git stops

Example prompts for the agent

  • Run aidd-vcs:01-commit to stage and commit pending changes
  • Open a GitLab merge request using the pull-request skill
  • Resolve deterministic git conflicts using the resolve-conflict skill

How to install aidd-vcs

Plugin marketplace

/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-vcs@aidd-framework

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about aidd-vcs

How to install aidd-vcs in Claude Code?

Run /plugin marketplace add ai-driven-dev/framework followed by /plugin install aidd-vcs@aidd-framework.

What does aidd-vcs do?

It manages VCS workflows including repository bootstrapping, atomic commits, pull requests, issue creation, semver tagging, and merge conflict resolution.

Which code hosts are supported for PRs?

The plugin includes templates and skills for GitHub pull requests and GitLab merge requests.

Source text

aidd-vcs · MIT
← [aidd-framework](../../README.md)

# aidd-vcs

VCS workflow plugin for the AI-Driven Development framework.

> Status: stable.

First time? Install with `/plugin install aidd-vcs@aidd-framework`, then run `aidd-vcs:01-commit`.

Flow: init once; commit each change; open PRs when ready; tag releases; file issues anywhere; resolve conflicts when Git stops.

Covers all external artifact creation: repo init, commits, pull/merge requests, release tags, issue tracking, and conflict resolution.

## Skills

| Bracket ID | Skill | Description |
|---|---|---|
| [3.0] | [repo-init](skills/00-repo-init/SKILL.md) | Initialize a repo: git init, default branch, bootstrap commit, CONTRIBUTING.md, optional remote. |
| [3.1] | [commit](skills/01-commit/SKILL.md) | Commit atomically; safely retry scoped hook fixes. |
| [3.2] | [pull-request](skills/02-pull-request/SKILL.md) | Create PR (GitHub) or MR (GitLab) with filled template. |
| [3.3] | [release-tag](skills/03-release-tag/SKILL.md) | Create and push a semantic version git tag with release notes. |
| [3.4] | [issue-create](skills/04-issue-create/SKILL.md) | Create issues in the configured ticketing tool. |
| [3.5] | [resolve-conflict](skills/05-resolve-conflict/SKILL.md) | Resolve deterministic conflicts or approved choices. |

## Assets

Each skill ships with VCS-specific templates in its `assets/` directory.

© AI-Driven Dev · MIT · ai-driven-dev/framework

Similar plugins

All plugins for Git and GitHub →

From the same set80

The whole set →
aidd-qa aidd-qa validates browser acceptance criteria against observable behavior and records short review videos. Useful right before submitting a completed task. CX Codex +1 ★ 571repo stars aidd-telemetry aidd-telemetry is a plugin for Claude Code that tracks token use in Claude Code and Codex sessions, grouped by task, model, or other dimensions. Records stay local. CX Codex +1 ★ 571repo stars aidd-ui aidd-ui is a plugin for the UI/UX direction of the AI-Driven Development framework; in alpha, its only smoke-test skill checks that the plugin loads. CX Codex +1 ★ 571repo stars aidd-refine The aidd-refine plugin for Claude Code provides five meta-cognition skills to sharpen vague prompts, find blind spots in written specs, check facts, and critique code against plans. CX Codex +1 ★ 571repo stars aidd-orchestrator aidd-orchestrator — a plugin for Claude Code, Cursor and other platforms that orchestrates synchronous development pipelines, automates issue-to-PR workflows, and manages product backlogs. CX Codex +1 ★ 571repo stars aidd-pm The aidd-pm plugin for Claude Code turns a rough idea into tickets a planner can consume through ten product skills. CX Codex +1 ★ 571repo stars aidd-dev aidd-dev is a Claude Code plugin for planning code changes, implementing them, and checking the results. Its skills also cover testing, refactoring, debugging, and parallel tasks. CX Codex +1 ★ 571repo stars aidd-context aidd-context — a knowledge-production plugin: onboarding, a project memory bank, generated context artifacts and Mermaid diagrams. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open