Skip to content

docs(telemetry): note the CLI sends which AI agent invoked it, not just whether - #2533

Merged
delucis merged 2 commits into
withastro:mainfrom
kobihikri:docs/telemetry-agent-identity
Jul 13, 2026
Merged

delucis merged 2 commits into
withastro:mainfrom
kobihikri:docs/telemetry-agent-identity

Conversation

@kobihikri

Copy link
Copy Markdown
Contributor

The telemetry page lists what the CLI collects, including:

Development environment (e.g. whether the CLI was invoked by an AI coding agent)

Since the agent-detection feature landed (withastro/astro#16610), the CLI actually sends a bit more than whether — it includes which agent. packages/astro/src/events/session.ts populates EventPayload with agentId (e.g. "claude-code"), agentName, and agentType (lines 15–21, 153–157), across the dev/build/preview/sync/add commands.

This is a one-line wording update so the disclosure matches what's sent — "whether — and which — AI coding agent invoked the CLI" — plus a bump of updated_date. Docs-only, no code.

Happy to reword if you'd phrase it differently; I just wanted the page to reflect the agent identity now being included.

AI-assisted; the session.ts fields I verified myself against astro main.

…ether

The telemetry page lists "whether the CLI was invoked by an AI coding agent". Since the
agent-detection feature (astro#16610), the CLI's EventPayload also carries the agent's
identity — `agentId` (e.g. "claude-code"), `agentName`, `agentType`
(packages/astro/src/events/session.ts:15-21, 153-157) — not just a boolean.

Updates the bullet to say "whether — and which — AI coding agent invoked the CLI", and
bumps updated_date. Docs-only.
@netlify

netlify Bot commented Jul 13, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for astro-www-2 ready!

Name Link
🔨 Latest commit 3ad144f
🔍 Latest deploy log https://app.netlify.com/projects/astro-www-2/deploys/6a5524337f624b0008d47401
😎 Deploy Preview https://deploy-preview-2533--astro-www-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@delucis delucis left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @kobihikri! This looks good to me.

Comment thread src/content/pages/telemetry.md Outdated
Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
@matthewp

Copy link
Copy Markdown
Contributor

Note that this page is not intended to be a list of everything that telemetry sends in detail. The code is open-source and that's how you know exactly what is sent. This page is just explaining the general purpose for telemetry and the types of data to be sent.

Change lgtm just want to make sure we don't set a precedent that any changes in telemetry then also much be synced to that page.

@delucis
delucis merged commit 445ac21 into withastro:main Jul 13, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants