rename again (#36)

Author: cjkenned

.claude/commands/implement.md

@@ -292,7 +292,7 @@ Then report:
 - Confirm Final Verification passed (gofmt clean, vet clean, build green, full test suite green)
 - Confirm `internal/spec/extracted_gen.go` is up to date if `SpecRef` changed
 - List any remaining manual verification items from the plan
-- Offer to create a commit, run additional probe commands (e.g., `./airbyte agents <new-cmd> --describe`), or other next steps
+- Offer to create a commit, run additional probe commands (e.g., `./airbyte-agent <new-cmd> --describe`), or other next steps
 
 ## Important Guidelines
 

.claude/commands/research.md

@@ -6,7 +6,7 @@ description: Research the codebase to understand how something works
 
 <!-- ultrathink -->
 
-You are tasked with conducting comprehensive research across the `airbyte` CLI codebase to answer the user's question by spawning parallel sub-agents and synthesizing their findings.
+You are tasked with conducting comprehensive research across the `airbyte-agent` CLI codebase to answer the user's question by spawning parallel sub-agents and synthesizing their findings.
 
 ## Research Question
 
@@ -70,7 +70,7 @@ Break down the research question into:
 | References `Resource`, `Operation`, `Register`, command surface, adding commands | **Resources** (`internal/resources/`) |
 | References `registry.Build`, Cobra flag generation, `--describe`, `--json`, `OperationHooks`, `ParamSchema` | **Registry** (`internal/registry/`) |
 | References HTTP, retries, `APIError`, status codes, `Get/Post/Patch/Delete` | **Client** (`internal/client/`) |
-| References credentials, OAuth, token caching, settings file, `~/.airbyte-cli/` | **Auth** (`internal/auth/`) |
+| References credentials, OAuth, token caching, settings file, `~/.airbyte-agent/` | **Auth** (`internal/auth/`) |
 | References `SKILL.md`, `skills/<command>/`, frontmatter | **Skills** (`skills/`) |
 | References `--format`, JSON/table output, `--fields`, `writeResult` | **Output** (`internal/output/`) |
 | References telemetry, Segment, `CLI Command Executed`, `is_internal_user` | **Telemetry** (`internal/telemetry/`) |
@@ -94,7 +94,7 @@ mkdir -p "$RESEARCH_TMP_DIR"
 ```
 Agent(subagent_type="Explore",
   description="Locate files for [topic]",
-  prompt="Find all files related to [topic] in the airbyte agents CLI.
+  prompt="Find all files related to [topic] in the airbyte-agent CLI.
 Look in cmd/, internal/registry/, internal/resources/, internal/client/, internal/auth/,
 internal/config/, internal/output/, internal/spec/, internal/telemetry/, skills/, api/.
 Return a categorized list: implementation files, test files (*_test.go), generated files
@@ -109,7 +109,7 @@ Use markdown format with file paths and brief descriptions.")
 ```
 Agent(subagent_type="general-purpose",
   description="Analyze how [topic] works",
-  prompt="Analyze how [topic] works in the airbyte agents CLI.
+  prompt="Analyze how [topic] works in the airbyte-agent CLI.
 Read the relevant Go files and trace the code path from main.go through the
 registry builder into the operation's Run function (and any PreRun hooks).
 Document with file:line references.
@@ -126,7 +126,7 @@ Use markdown format with file:line references.")
 ```
 Agent(subagent_type="general-purpose",
   description="Find patterns matching [topic]",
-  prompt="Find existing examples of [pattern type] in the airbyte agents CLI.
+  prompt="Find existing examples of [pattern type] in the airbyte-agent CLI.
 Look at how other resources in internal/resources/ implement the same Resource/Operation
 interface — workspaces.go, organizations.go, and connectors.go are good reference points.
 Look at how their tests in *_test.go use newTestTokenServer() and newTestClient() helpers.
@@ -169,7 +169,7 @@ Focus on:
   (3x exponential backoff on 429/502/503/504), 30s timeout, X-ADP-Agent-CLI header
 - internal/client/errors.go: APIError struct, ExitCode() mapping (auth=2, not-found=3, validation=4)
 - internal/auth/credentials.go: ResolveSettings — env vars first (all three required),
-  then ~/.airbyte-cli/settings.json
+  then ~/.airbyte-agent/settings.json
 - internal/auth/credentials_file.go: atomic writes, 0600 permission enforcement
 - internal/auth/token.go: TokenManager OAuth caching and auto-refresh
 
@@ -200,7 +200,7 @@ Use markdown format with file:line references.")
 ```
 Agent(subagent_type="general-purpose",
   description="Cross-cutting analysis of [topic]",
-  prompt="Analyze how [topic] interacts across the airbyte agents CLI's packages.
+  prompt="Analyze how [topic] interacts across the airbyte-agent CLI's packages.
 Trace the flow from main.go (config -> auth -> client -> registry -> Cobra) through
 the relevant packages. Identify which packages collaborate and via what interfaces.
 

.claude/commands/spec.md

@@ -92,7 +92,7 @@ options:
 
 | Signal | Domain |
 |--------|--------|
-| New `airbyte agents <noun> <verb>` command, new resource, new operation | **Resources** (`internal/resources/`) |
+| New `airbyte-agent <noun> <verb>` command, new resource, new operation | **Resources** (`internal/resources/`) |
 | Changes to registry building, flag generation, `--describe`, `--json`, validation | **Registry** (`internal/registry/`) |
 | HTTP retries, status codes, error mapping, new transport headers | **Client** (`internal/client/`) |
 | Credentials, OAuth, settings file, token caching | **Auth** (`internal/auth/`) |
@@ -119,13 +119,13 @@ options:
 Agent(subagent_type="Explore",
   description="Locate files for [feature area]",
   prompt="CONSTRAINT: READ-ONLY mode — do NOT create, modify, or delete any files.
-Find WHERE all files related to [feature area] live in the airbyte agents CLI.
+Find WHERE all files related to [feature area] live in the airbyte-agent CLI.
 Look in cmd/, internal/, skills/, api/. Return categorized list with file purposes.")
 
 Agent(subagent_type="general-purpose",
   description="Analyze [related feature]",
   prompt="CONSTRAINT: READ-ONLY mode — do NOT create, modify, or delete any files.
-Understand HOW [related feature] currently works in the airbyte agents CLI.
+Understand HOW [related feature] currently works in the airbyte-agent CLI.
 Read the implementation and document the patterns used. Include file:line references.
 Do NOT suggest improvements.")
 
@@ -277,7 +277,7 @@ domain: [resources | registry | client | auth | skills | output | telemetry | sc
 
 [2-3 sentence summary of what we're building and why.]
 
-**Recommended /implement mode**: standard (the airbyte agents CLI uses sequential phases — no team mode).
+**Recommended /implement mode**: standard (the airbyte-agent CLI uses sequential phases — no team mode).
 
 ### Constraints
 
@@ -329,7 +329,7 @@ go test ./internal/<package>/... -run <TestName> -v
 
 #### Manual Verification
 
-- [ ] [User-facing behavior to test by hand, e.g., "run `airbyte agents connectors describe --json '{...}'` against a real workspace"]
+- [ ] [User-facing behavior to test by hand, e.g., "run `airbyte-agent connectors describe --json '{...}'` against a real workspace"]
 
 ### Phase 2: [Phase Name]
 

.github/workflows/release.yml

@@ -25,16 +25,16 @@ jobs:
 
       # Mint a token for the octavia-bot GitHub App, scoped to this repo
       # plus airbytehq/homebrew-tap so goreleaser can commit the brew formula
-      # there. Reuses the same App credentials as the sync-openapi-to-airbyte-cli
-      # workflow in the sonar repo. Requires the App installation to grant
-      # `contents: write` on both repos.
+      # there. Reuses the same App credentials as the
+      # sync-openapi-to-airbyte-agent-cli workflow in the sonar repo. Requires
+      # the App installation to grant `contents: write` on both repos.
       - name: Authenticate as GitHub App
         id: get-app-token
         uses: actions/create-github-app-token@fee1f7d63c2ff003460e3d139729b119787bc349 # v2.2.2
         with:
           owner: "airbytehq"
           repositories: |
-            airbyte-cli
+            airbyte-agent-cli
             homebrew-tap
           app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
           private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
@@ -52,8 +52,8 @@ jobs:
           # uploads archives, the source bundle, and the checksums file here.
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           # Cross-repo token (App-minted): lets goreleaser commit
-          # Formula/airbyte-cli.rb to airbytehq/homebrew-tap.
+          # Formula/airbyte-agent-cli.rb to airbytehq/homebrew-tap.
           HOMEBREW_TAP_GITHUB_TOKEN: ${{ steps.get-app-token.outputs.token }}
           # Skill version stamped into the binary via cmd.ExpectedSkillVersion.
-          # Sourced from skills/airbyte-agents/SKILL.md by the previous step.
+          # Sourced from skills/airbyte-agent/SKILL.md by the previous step.
           SKILL_VERSION: ${{ env.SKILL_VERSION }}

.github/workflows/skill-version-bump.yml

@@ -3,7 +3,7 @@ name: skill-version-bump
 on:
   pull_request:
     paths:
-      - 'skills/airbyte-agents/**'
+      - 'skills/airbyte-agent/**'
 
 permissions:
   contents: read
@@ -27,12 +27,12 @@ jobs:
             echo "::notice::Head is v0.1.0 — treating as bootstrap/reset."
             exit 0
           fi
-          if ! base=$(git show "origin/${{ github.base_ref }}":skills/airbyte-agents/SKILL.md 2>/dev/null | ./scripts/skill-version.sh /dev/stdin 2>/dev/null); then
+          if ! base=$(git show "origin/${{ github.base_ref }}":skills/airbyte-agent/SKILL.md 2>/dev/null | ./scripts/skill-version.sh /dev/stdin 2>/dev/null); then
             echo "::notice::Base branch has no skill version yet — accepting head=$head as the bootstrap."
             exit 0
           fi
           if [ "$head" = "$base" ]; then
-            echo "::error::Skill version not bumped ($base unchanged). Bump skills/airbyte-agents/SKILL.md metadata.version."
+            echo "::error::Skill version not bumped ($base unchanged). Bump skills/airbyte-agent/SKILL.md metadata.version."
             exit 1
           fi
           greater=$(printf '%s\n%s\n' "$base" "$head" | sort -V | tail -1)

.gitignore

@@ -1,5 +1,5 @@
 # Binaries
-/airbyte
+/airbyte-agent
 *.exe
 *.exe~
 *.dll
@@ -38,7 +38,7 @@ Thumbs.db
 .env
 .env.local
 .airbyte/
-.airbyte-cli/
+.airbyte-agent/
 credentials
 
 # Research and planning artifacts (used by /research, /spec, /implement)

.goreleaser.yaml

@@ -1,25 +1,25 @@
 version: 2
 
-project_name: airbyte
+project_name: airbyte-agent
 
 before:
   hooks:
     - go mod tidy
 
 builds:
-  - id: airbyte
+  - id: airbyte-agent
     main: .
-    binary: airbyte
+    binary: airbyte-agent
     env:
       - CGO_ENABLED=0
     flags:
       - -trimpath
     ldflags:
       - -s -w
-      - -X github.com/airbytehq/airbyte-cli/cmd.Version={{.Version}}
-      - -X github.com/airbytehq/airbyte-cli/cmd.Commit={{.Commit}}
-      - -X github.com/airbytehq/airbyte-cli/cmd.Date={{.Date}}
-      - -X github.com/airbytehq/airbyte-cli/cmd.ExpectedSkillVersion={{.Env.SKILL_VERSION}}
+      - -X github.com/airbytehq/airbyte-agent-cli/cmd.Version={{.Version}}
+      - -X github.com/airbytehq/airbyte-agent-cli/cmd.Commit={{.Commit}}
+      - -X github.com/airbytehq/airbyte-agent-cli/cmd.Date={{.Date}}
+      - -X github.com/airbytehq/airbyte-agent-cli/cmd.ExpectedSkillVersion={{.Env.SKILL_VERSION}}
     goos:
       - linux
       - darwin
@@ -64,8 +64,8 @@ release:
   prerelease: auto
   name_template: "v{{ .Version }}"
 
-# Homebrew formula generation. Goreleaser commits Formula/airbyte-cli.rb to
-# the airbytehq/homebrew-tap repo on each non-prerelease release. Cross-repo
+# Homebrew formula generation. Goreleaser commits Formula/airbyte-agent-cli.rb
+# to the airbytehq/homebrew-tap repo on each non-prerelease release. Cross-repo
 # write requires a separate token (HOMEBREW_TAP_GITHUB_TOKEN) — the default
 # GITHUB_TOKEN issued by the workflow only has access to this repo.
 #
@@ -74,21 +74,21 @@ release:
 # macOS binaries and our binaries are unsigned. Revisit when goreleaser removes
 # `brews` entirely or when we start signing release binaries.
 #
-# Formula is named `airbyte-cli` (to match the repo); the installed binary
-# is `airbyte` (short, what users actually type).
+# Formula is named `airbyte-agent-cli` (to match the repo); the installed
+# binary is `airbyte-agent`.
 brews:
-  - name: airbyte-cli
+  - name: airbyte-agent-cli
     repository:
       owner: airbytehq
       name: homebrew-tap
       token: "{{ .Env.HOMEBREW_TAP_GITHUB_TOKEN }}"
       branch: main
     directory: Formula
-    homepage: https://github.com/airbytehq/airbyte-cli
+    homepage: https://github.com/airbytehq/airbyte-agent-cli
     description: CLI for Airbyte, designed for use by both humans and agents
     license: Elastic-2.0
     install: |
-      bin.install "airbyte"
+      bin.install "airbyte-agent"
     test: |
-      system "#{bin}/airbyte", "agents", "version"
+      system "#{bin}/airbyte-agent", "version"
     skip_upload: auto # don't update the formula for prereleases (e.g. v0.1.0-rc1)