Installation

Shared Agents installs to ~/.shared-agents by default (override with $SHARED_AGENTS_HOME).

Recommended: bootstrap (one command)

curl -fsSL https://raw.githubusercontent.com/netgrade-digital/shared-agents/refs/heads/main/scripts/bootstrap.sh | bash

The wizard:

Clones or updates Core into your home directory
Optionally configures your private team Git remote
Runs sa install for detected AI tools
Adds the sa shell command to ~/.bashrc

Then:

source ~/.bashrc
sa check
sa team verify    # recommended after team setup

Non-interactive (CI / scripts)

SA_BOOTSTRAP_NON_INTERACTIVE=1 curl -fsSL https://raw.githubusercontent.com/netgrade-digital/shared-agents/refs/heads/main/scripts/bootstrap.sh | bash

Alternative: clone + install

Core only (team repo optional in wizard):

git clone git@github.com:netgrade-digital/shared-agents.git ~/.shared-agents
cd ~/.shared-agents
sa install
source ~/.bashrc

From a dev checkout (repo on disk, install into home):

git clone git@github.com:netgrade-digital/shared-agents.git ~/Development/shared-agents
cd ~/Development/shared-agents
./sa install --home "$HOME/.shared-agents"
source ~/.bashrc

Install wizard (`sa install`)

Interactive when run in a TTY:

sa install

Step	What you choose
Install path	Default `~/.shared-agents` or custom
Tools	Which adapters to configure (↑↓, Space, `a` all, `d` detected)
Team repo URL	Optional private remote for learnings/skills/rules
Shell CLI	Add `sa` to bashrc

Quick / CI:

sa install --non-interactive
sa install --non-interactive --tools cursor,claude-code
sa install --dry-run

Alias: sa install = sa setup

After installation

Check	Command
Tools configured	`sa check`
Team layout OK	`sa team verify`
Open tasks	`sa status`
Live command list	`sa help`

New AI tool on your machine?

Run sa install again — it only configures tools detected as installed.

Development setup (Core contributors)

git clone git@github.com:netgrade-digital/shared-agents.git
cd shared-agents
./sa install --home "$HOME/.shared-agents"
source ~/.bashrc
sa install --dry-run
sa check

Work in the clone; test with sa pointing at $SHARED_AGENTS_HOME. See Contributing.

Uninstall

sa uninstall              # prompts
sa uninstall -y
sa uninstall --keep-repo  # remove adapters only; keep ~/.shared-agents

Then source ~/.bashrc. Fresh setup: sa bootstrap.

Troubleshooting

See Troubleshooting for sa: command not found, half-finished wizard, and adapter issues.