Zejnilovic/agd

Your agentic setup, versioned like a dependency.
Install and update instructions, agents, skills and hooks from git repositories,
without overwriting what your project changed.
Docs ·
Install ·
Quick start ·
How it works ·
Publish your own setup
A good agentic setup takes work: AGENTS.md, agents for each role, skills, hooks. You want it in every project, and you want every project to get its improvements. Copies drift, and copying a new version over an old one wipes out what each project changed, so nobody updates.
agd keeps a setup in a git repository, installs it into your projects at a version, and updates it while keeping each project's own changes. The default setup is agentic-defaults; any repository laid out as a source works, and several can share a project.
console
$ agd init @0.2.0
Installed agentic-defaults 0.2.0: 36 files from the packs core.
Commit .agd.lock along with the new files.
$ agd status # weeks later: you chose opus for the reviewer, and edited a skill
agentic-defaults 0.2.0 is installed, and 0.3.0 is available: run agd update.
notes https://github.com/Zejnilovic/agentic-defaults/releases/tag/v0.3.0
update .claude/agents/analyst.md
...
model .claude/agents/reviewer.md: opus (kit: sonnet)
edited .claude/skills/tdd/SKILL.md, newer version available: see agd diff .claude/skills/tdd/SKILL.md, then agd merge or agd reset it
...
$ agd update
...
agentic-defaults is at 0.3.0: 30 updated, 1 added, 0 removed.
Review the changes with git diff, and commit .agd.lock with them.
Versioned. Sources publish releases as git tags. A project installs one, records it in .agd.lock, and updates with one command, with links to the release notes.
Plain files in your repository. Your agents read them as they are, people review them in pull requests. No plugin, no runtime, any assistant: Claude Code, GitHub Copilot, Cursor, Codex and others.
Never overwrites your work. Updates keep an agent's model: and tools: lines and a ## This project section. A file you changed elsewhere is left alone and reported, and agd diff, agd merge and agd reset settle it.
Composable. Install only the packs you need, and stack your team's setup on top of agentic-defaults.
Small enough to trust. One bash script that needs only git. It never runs code from a source.
## Install
bash
brew install zejnilovic/tap/agd
Without Homebrew, on macOS, Linux, WSL or Git Bash:
bash
curl -fsSL https://raw.githubusercontent.com/Zejnilovic/agd/main/install.sh | bash
The install script puts the latest release in ~/.local/bin; run it again to update. You can also download agd from the latest release, make it executable and put it on your PATH, or run bin/agd from a clone. Install has every way, with checksums and Windows notes, and how to turn on tab completion: source works too
agd status # what an update would do
agd update # move to the latest release
Commit .agd.lock with the files, so your team gets the same setup. The quick start walks through a first install, making files your own and a first update.