atl

AI agent teams, installed like packages.
_{A package manager CLI for the AgentTeamLand ecosystem.}

---

In 30 seconds

# macOS / Linux
brew install agentteamland/tap/atl

# Windows
scoop bucket add agentteamland https://github.com/agentteamland/scoop-bucket
scoop install atl

# Then, in any project:
atl install software-project-team          # 13 specialized agents arrive
#   → .NET API + Flutter + React + Postgres + RabbitMQ + Redis + Elasticsearch + MinIO

atl installs teams — curated sets of AI agents (plus their skills and rules) — from a public registry or any git URL, into your current project's .claude/ directory. Teams can extend other teams, override agents by name, or exclude inherited agents they don't need.

Install

macOS / Linux (Homebrew — recommended)

brew install agentteamland/tap/atl

or:

brew tap agentteamland/tap
brew install atl

Windows (Scoop — recommended)

scoop bucket add agentteamland https://github.com/agentteamland/scoop-bucket
scoop install atl

Windows (winget — after first Microsoft review completes)

winget install agentteamland.atl

One-liner fallback (macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/agentteamland/cli/main/scripts/install.sh | sh

Manual

Download the latest release for your platform from releases, extract, and move the binary into your $PATH.

Build from source (no Go on host)

git clone https://github.com/agentteamland/cli.git
cd cli
./scripts/build.sh                   # Dockerized build → bin/atl

Usage

atl install <team>                   # registry lookup by name
atl install agentteamland/<team>     # owner/repo shorthand (GitHub)
atl install <https-git-url>          # direct URL (works for any host)

atl list                             # show installed teams + effective counts
atl remove <team>                    # unlinks symlinks; cached repo stays
atl update [team]                    # pull updates; refresh all symlinks
atl search <keyword>                 # search the public registry
atl --version
atl --help

Examples:

atl install software-project-team

atl install starter-extended         # inherits software-project-team,
                                     # adds stripe-agent, excludes ux-agent

atl list
# ✓ starter-extended@0.1.0
#    extends: software-project-team@1.0.0
#    effective: 13 agents, 2 skills, 0 rules

How it works

Every installable team is a git repository with a team.json at its root declaring its identity, agents/skills/rules, and (optionally) an extends parent.

atl install <name> walks the inheritance chain (unlimited depth, cycle-detected), merges the effective agent/skill/rule set with child overrides parent semantics (and honoring excludes), then creates symlinks from the cached source repos into your project's .claude/agents/, .claude/skills/, .claude/rules/.

Cached source repos live in ~/.claude/repos/agentteamland/ and are shared across all projects on the machine. Only the project-level symlinks differ.

Submit your team to the registry

Open a PR against agentteamland/registry. Full guide: CONTRIBUTING.md.

Status

v0.1.0 — install, list, remove, update, search, registry name-resolution, unlimited-depth extends with excludes + override, circular detection.

Roadmap:

• brew tap formula
• atl doctor (diagnostics)
• atl team submit (interactive registry PR)
• atl new-project (team-scoped scaffolder dispatch)
• Version-constraint enforcement (caret/tilde/exact)

License

MIT.