add-team-source

name

add-team-source

description

Register a git URL as a team-profile source so nyann can periodically sync and expose its profiles under a namespace. TRIGGER when the user says "add a team profile source", "register a team profile source", "set up team profiles from <url>", "wire up our team's shared profiles at <repo>", "add profile source named X at <url>", "install team profiles from <git repo>", "/nyann:add-team-source". Do NOT trigger on "sync team profiles now" (that's `sync-team-profiles` — the pull operation). Do NOT trigger on "save my setup as a profile" (that's `learn-profile` — writes to user root, not a team source). Do NOT trigger on generic "add a repo" or "add a remote" — those are git operations unrelated to profile distribution.

add-team-source

Wraps bin/add-team-source.sh. Updates ~/.claude/nyann/config.json to declare a new team-profile source. Idempotent — passing the same --name updates the entry in place.

1. Collect inputs

• --name <id> — required. Short slug, ^[a-z0-9][a-z0-9-]*$. Will also become the namespace prefix for team profiles (e.g. platform-team/base when name is platform-team). When the user gives a name with spaces or caps, propose a slug and confirm.
• --url <git-url> — required. Any URL git can clone (https://, git@, file:// for testing).
• --ref <branch-or-tag> — default main. Override when the team pins a specific branch or tag.
• --interval <hours> — default 24. How often sync-team-profiles will re-pull from this source without --force. Decrease only when the user says "we update these often" or similar.

2. Pre-flight

• Config path defaults to ~/.claude/nyann/config.json. Override only when the user explicitly names a different user root.
• The backend upserts on --name collision. Warn the user if they're replacing an existing source with a different URL — that's usually unintentional. Read current config first if unsure.

3. Invoke

bin/add-team-source.sh \
  --name <id> \
  --url <git-url> \
  [--ref <branch>] \
  [--interval <hours>] \
  [--user-root <dir>]

Exit 0 on success; config path is logged to stderr.

4. Report back

• Name, URL, ref, interval.
• Tell the user "Run /nyann:sync-team-profiles (or ask 'sync my team profiles') to actually pull them". add-team-source only registers — the pull is a separate operation on purpose (no surprise network calls here).

When to hand off

• "Now pull them" → sync-team-profiles skill.
• "Apply a team profile to this repo" → bootstrap-project with the namespaced profile name (e.g. platform-team/base).
• "Show what the team profile does" → inspect-profile with the namespaced name.