Install Adams

You need Python 3.9+, Node 18+ and git. LibreOffice is optional, for pptx and docx checks.

Claude Code plugin

Two commands inside Claude Code, then start a new session. The skill appears as adams:adams, and /plugin lists what is installed.

claude
/plugin marketplace add UpgradIQ/adams
/plugin install adams@adams

Any terminal

Works in any shell and sets up Claude Code and Copilot CLI together. Preview with --dry-run first. Use one method, not both: if the plugin is enabled, adams install skips the skill link and hooks.

zsh
git clone https://github.com/UpgradIQ/adams.git ~/adams
~/adams/bin/adams install --dry-run
~/adams/bin/adams install
export PATH="$HOME/.local/bin:$PATH"
adams sync
adams doctor

Copilot CLI

The clone install links the skill into ~/.copilot/skills/adams. adams sync writes the Copilot instructions file, since Copilot has no prompt hook.

zsh
adams install
adams sync

Check your setup

adams doctor prints the installed version, what is missing and how to fix it. If your app does not load marketplace plugins, --link links the skill and registers the hooks anyway.

zsh
adams doctor
adams install --link

Staying up to date

Claude Code does not auto-update third-party marketplaces by default. Turn it on once in /plugin, under Marketplaces, then choose adams. A clone updates itself: a session-start hook runs at most once a day, follows release tags only and touches only a clean clone.

zsh
claude plugin marketplace update adams
claude plugin update adams@adams
adams update
adams update --check

The first two update a plugin install, then restart the session. adams update moves a clone now. --check only asks. Set ADAMS_AUTO_UPDATE=0 to opt out of the daily check.

Opting out

Before the agent stops, Adams runs the text check on changed .md and .txt files and asks for fixes once. Set ADAMS_STOP=0 to turn that off. adams uninstall removes exactly what install added.

zsh
export ADAMS_STOP=0
adams uninstall

What it touches

Read this before you install. There is no telemetry, and ADAMS_AUTO_INSTALL=0 forbids dependency installs.

  • Symlinks for the skill and adams.
  • Two local hooks in ~/.claude/settings.json, which is backed up first.
  • Pinned layout dependencies on first use.
  • No network calls from hooks except the daily release check on clone installs.