fix(cli-core): support agent-mode link and unlink by wyattjoh · Pull Request #212 · clerk/cli

wyattjoh · 2026-04-22T17:55:28Z

Summary

clerk link and clerk unlink previously hard-returned in agent mode, even when the caller had already provided the flags needed to make the operation deterministic. That kept non-interactive flows like init, onboarding, and app switching from completing end-to-end under an agent harness, and the bundled skills/clerk docs had to document the limitation instead of the intended workflow. This change removes the blanket agent-mode block, preserves the safety checks that actually matter, and updates the skill/docs to match the new behavior.

What changed

link now supports deterministic agent-mode flows. In agent mode, clerk link --app <id> links directly, and the no-flag path first tries silent autolink from detected keys. If the CLI still cannot determine the target app without a picker, it exits with a usage error telling the caller to pass --app or inspect clerk apps list --json.
unlink now works in agent mode with explicit confirmation. The unconditional agent-mode early return is gone. clerk unlink --yes removes the link non-interactively, while omitting --yes now fails with a usage error instead of printing guidance.
The integration coverage now exercises the agent flows that were previously skipped. Agent-mode success/error cases were added for link and unlink, and the previously disabled agent variants of the onboard and switch-app flows are now enabled so the non-interactive path is covered end-to-end.
Bundled docs and the tracked Clerk skill were updated to match runtime behavior. The command READMEs and skills/clerk/* now describe deterministic agent linking, unlink --yes, and the current agent-mode error semantics instead of documenting the old limitation.

Test plan

bun test packages/cli-core/src/commands/link/index.test.ts packages/cli-core/src/commands/unlink/index.test.ts packages/cli-core/src/test/integration/agent-mode.test.ts packages/cli-core/src/test/integration/onboard.test.ts packages/cli-core/src/test/integration/switch-apps.test.ts
bun run --filter @clerk/cli-core build
Built-JS smoke checks for --version, doctor --json, completion zsh, init --prompt, api ls users, and the new agent-mode link / unlink usage errors
Authenticated manual smoke test against a live Clerk app from this agent environment

changeset-bot · 2026-04-22T17:55:32Z

🦋 Changeset detected

Latest commit: 0644ff1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-04-22T17:59:21Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: dcf489e7-1526-46b4-801f-46a1f2ebb977

📥 Commits

Reviewing files that changed from the base of the PR and between a6f55e5 and 0644ff1.

📒 Files selected for processing (1)

packages/cli-core/src/commands/link/index.ts

🚧 Files skipped from review as they are similar to previous changes (1)

packages/cli-core/src/commands/link/index.ts

📝 Walkthrough

Walkthrough

The PR changes agent-mode behavior for clerk link and clerk unlink. clerk link now runs deterministic non-interactive flows: --app <id> performs a direct fetch-and-link; a bare clerk link will attempt a silent deterministic autolink from detected publishable keys and otherwise throws a usage error instead of prompting. clerk unlink in agent mode requires --yes to proceed; omitting --yes now throws a usage error. Changes touch command implementations, tests (unit and integration), documentation, and skill/reference materials; the previous agent prompt/logging constant was removed and usage-error helpers were added.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'fix(cli-core): support agent-mode link and unlink' clearly and concisely summarizes the main change: adding support for agent-mode operations in the link and unlink commands.
Description check	✅ Passed	The description comprehensively explains the changeset, detailing what changed in link/unlink behavior, integration test coverage updates, and documentation improvements, all directly related to the PR's core objective.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

wyattjoh · 2026-04-22T17:55:28Z

Summary

clerk link and clerk unlink previously hard-returned in agent mode, even when the caller had already provided the flags needed to make the operation deterministic. That kept non-interactive flows like init, onboarding, and app switching from completing end-to-end under an agent harness, and the bundled skills/clerk docs had to document the limitation instead of the intended workflow. This change removes the blanket agent-mode block, preserves the safety checks that actually matter, and updates the skill/docs to match the new behavior.

What changed

link now supports deterministic agent-mode flows. In agent mode, clerk link --app <id> links directly, and the no-flag path first tries silent autolink from detected keys. If the CLI still cannot determine the target app without a picker, it exits with a usage error telling the caller to pass --app or inspect clerk apps list --json.
unlink now works in agent mode with explicit confirmation. The unconditional agent-mode early return is gone. clerk unlink --yes removes the link non-interactively, while omitting --yes now fails with a usage error instead of printing guidance.
The integration coverage now exercises the agent flows that were previously skipped. Agent-mode success/error cases were added for link and unlink, and the previously disabled agent variants of the onboard and switch-app flows are now enabled so the non-interactive path is covered end-to-end.
Bundled docs and the tracked Clerk skill were updated to match runtime behavior. The command READMEs and skills/clerk/* now describe deterministic agent linking, unlink --yes, and the current agent-mode error semantics instead of documenting the old limitation.

Test plan

bun test packages/cli-core/src/commands/link/index.test.ts packages/cli-core/src/commands/unlink/index.test.ts packages/cli-core/src/test/integration/agent-mode.test.ts packages/cli-core/src/test/integration/onboard.test.ts packages/cli-core/src/test/integration/switch-apps.test.ts
bun run --filter @clerk/cli-core build
Built-JS smoke checks for --version, doctor --json, completion zsh, init --prompt, api ls users, and the new agent-mode link / unlink usage errors
Authenticated manual smoke test against a live Clerk app from this agent environment

changeset-bot · 2026-04-22T17:55:32Z

🦋 Changeset detected

Latest commit: 0644ff1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-04-22T17:59:21Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: dcf489e7-1526-46b4-801f-46a1f2ebb977

📥 Commits

Reviewing files that changed from the base of the PR and between a6f55e5 and 0644ff1.

📒 Files selected for processing (1)

packages/cli-core/src/commands/link/index.ts

🚧 Files skipped from review as they are similar to previous changes (1)

packages/cli-core/src/commands/link/index.ts

📝 Walkthrough

Walkthrough

The PR changes agent-mode behavior for clerk link and clerk unlink. clerk link now runs deterministic non-interactive flows: --app <id> performs a direct fetch-and-link; a bare clerk link will attempt a silent deterministic autolink from detected publishable keys and otherwise throws a usage error instead of prompting. clerk unlink in agent mode requires --yes to proceed; omitting --yes now throws a usage error. Changes touch command implementations, tests (unit and integration), documentation, and skill/reference materials; the previous agent prompt/logging constant was removed and usage-error helpers were added.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'fix(cli-core): support agent-mode link and unlink' clearly and concisely summarizes the main change: adding support for agent-mode operations in the link and unlink commands.
Description check	✅ Passed	The description comprehensively explains the changeset, detailing what changed in link/unlink behavior, integration test coverage updates, and documentation improvements, all directly related to the PR's core objective.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

wyattjoh · 2026-04-22T17:55:28Z

Summary

clerk link and clerk unlink previously hard-returned in agent mode, even when the caller had already provided the flags needed to make the operation deterministic. That kept non-interactive flows like init, onboarding, and app switching from completing end-to-end under an agent harness, and the bundled skills/clerk docs had to document the limitation instead of the intended workflow. This change removes the blanket agent-mode block, preserves the safety checks that actually matter, and updates the skill/docs to match the new behavior.

What changed

link now supports deterministic agent-mode flows. In agent mode, clerk link --app <id> links directly, and the no-flag path first tries silent autolink from detected keys. If the CLI still cannot determine the target app without a picker, it exits with a usage error telling the caller to pass --app or inspect clerk apps list --json.
unlink now works in agent mode with explicit confirmation. The unconditional agent-mode early return is gone. clerk unlink --yes removes the link non-interactively, while omitting --yes now fails with a usage error instead of printing guidance.
The integration coverage now exercises the agent flows that were previously skipped. Agent-mode success/error cases were added for link and unlink, and the previously disabled agent variants of the onboard and switch-app flows are now enabled so the non-interactive path is covered end-to-end.
Bundled docs and the tracked Clerk skill were updated to match runtime behavior. The command READMEs and skills/clerk/* now describe deterministic agent linking, unlink --yes, and the current agent-mode error semantics instead of documenting the old limitation.

Test plan

bun test packages/cli-core/src/commands/link/index.test.ts packages/cli-core/src/commands/unlink/index.test.ts packages/cli-core/src/test/integration/agent-mode.test.ts packages/cli-core/src/test/integration/onboard.test.ts packages/cli-core/src/test/integration/switch-apps.test.ts
bun run --filter @clerk/cli-core build
Built-JS smoke checks for --version, doctor --json, completion zsh, init --prompt, api ls users, and the new agent-mode link / unlink usage errors
Authenticated manual smoke test against a live Clerk app from this agent environment

changeset-bot · 2026-04-22T17:55:32Z

🦋 Changeset detected

Latest commit: 0644ff1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-04-22T17:59:21Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: dcf489e7-1526-46b4-801f-46a1f2ebb977

📥 Commits

Reviewing files that changed from the base of the PR and between a6f55e5 and 0644ff1.

📒 Files selected for processing (1)

packages/cli-core/src/commands/link/index.ts

🚧 Files skipped from review as they are similar to previous changes (1)

packages/cli-core/src/commands/link/index.ts

📝 Walkthrough

Walkthrough

The PR changes agent-mode behavior for clerk link and clerk unlink. clerk link now runs deterministic non-interactive flows: --app <id> performs a direct fetch-and-link; a bare clerk link will attempt a silent deterministic autolink from detected publishable keys and otherwise throws a usage error instead of prompting. clerk unlink in agent mode requires --yes to proceed; omitting --yes now throws a usage error. Changes touch command implementations, tests (unit and integration), documentation, and skill/reference materials; the previous agent prompt/logging constant was removed and usage-error helpers were added.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'fix(cli-core): support agent-mode link and unlink' clearly and concisely summarizes the main change: adding support for agent-mode operations in the link and unlink commands.
Description check	✅ Passed	The description comprehensively explains the changeset, detailing what changed in link/unlink behavior, integration test coverage updates, and documentation improvements, all directly related to the PR's core objective.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

wyattjoh · 2026-04-22T17:55:28Z

Summary

clerk link and clerk unlink previously hard-returned in agent mode, even when the caller had already provided the flags needed to make the operation deterministic. That kept non-interactive flows like init, onboarding, and app switching from completing end-to-end under an agent harness, and the bundled skills/clerk docs had to document the limitation instead of the intended workflow. This change removes the blanket agent-mode block, preserves the safety checks that actually matter, and updates the skill/docs to match the new behavior.

What changed

link now supports deterministic agent-mode flows. In agent mode, clerk link --app <id> links directly, and the no-flag path first tries silent autolink from detected keys. If the CLI still cannot determine the target app without a picker, it exits with a usage error telling the caller to pass --app or inspect clerk apps list --json.
unlink now works in agent mode with explicit confirmation. The unconditional agent-mode early return is gone. clerk unlink --yes removes the link non-interactively, while omitting --yes now fails with a usage error instead of printing guidance.
The integration coverage now exercises the agent flows that were previously skipped. Agent-mode success/error cases were added for link and unlink, and the previously disabled agent variants of the onboard and switch-app flows are now enabled so the non-interactive path is covered end-to-end.
Bundled docs and the tracked Clerk skill were updated to match runtime behavior. The command READMEs and skills/clerk/* now describe deterministic agent linking, unlink --yes, and the current agent-mode error semantics instead of documenting the old limitation.

Test plan

bun test packages/cli-core/src/commands/link/index.test.ts packages/cli-core/src/commands/unlink/index.test.ts packages/cli-core/src/test/integration/agent-mode.test.ts packages/cli-core/src/test/integration/onboard.test.ts packages/cli-core/src/test/integration/switch-apps.test.ts
bun run --filter @clerk/cli-core build
Built-JS smoke checks for --version, doctor --json, completion zsh, init --prompt, api ls users, and the new agent-mode link / unlink usage errors
Authenticated manual smoke test against a live Clerk app from this agent environment

changeset-bot · 2026-04-22T17:55:32Z

🦋 Changeset detected

Latest commit: 0644ff1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-04-22T17:59:21Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: dcf489e7-1526-46b4-801f-46a1f2ebb977

📥 Commits

Reviewing files that changed from the base of the PR and between a6f55e5 and 0644ff1.

📒 Files selected for processing (1)

packages/cli-core/src/commands/link/index.ts

🚧 Files skipped from review as they are similar to previous changes (1)

packages/cli-core/src/commands/link/index.ts

📝 Walkthrough

Walkthrough

The PR changes agent-mode behavior for clerk link and clerk unlink. clerk link now runs deterministic non-interactive flows: --app <id> performs a direct fetch-and-link; a bare clerk link will attempt a silent deterministic autolink from detected publishable keys and otherwise throws a usage error instead of prompting. clerk unlink in agent mode requires --yes to proceed; omitting --yes now throws a usage error. Changes touch command implementations, tests (unit and integration), documentation, and skill/reference materials; the previous agent prompt/logging constant was removed and usage-error helpers were added.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'fix(cli-core): support agent-mode link and unlink' clearly and concisely summarizes the main change: adding support for agent-mode operations in the link and unlink commands.
Description check	✅ Passed	The description comprehensively explains the changeset, detailing what changed in link/unlink behavior, integration test coverage updates, and documentation improvements, all directly related to the PR's core objective.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

wyattjoh · 2026-04-22T17:55:28Z

Summary

clerk link and clerk unlink previously hard-returned in agent mode, even when the caller had already provided the flags needed to make the operation deterministic. That kept non-interactive flows like init, onboarding, and app switching from completing end-to-end under an agent harness, and the bundled skills/clerk docs had to document the limitation instead of the intended workflow. This change removes the blanket agent-mode block, preserves the safety checks that actually matter, and updates the skill/docs to match the new behavior.

What changed

link now supports deterministic agent-mode flows. In agent mode, clerk link --app <id> links directly, and the no-flag path first tries silent autolink from detected keys. If the CLI still cannot determine the target app without a picker, it exits with a usage error telling the caller to pass --app or inspect clerk apps list --json.
unlink now works in agent mode with explicit confirmation. The unconditional agent-mode early return is gone. clerk unlink --yes removes the link non-interactively, while omitting --yes now fails with a usage error instead of printing guidance.
The integration coverage now exercises the agent flows that were previously skipped. Agent-mode success/error cases were added for link and unlink, and the previously disabled agent variants of the onboard and switch-app flows are now enabled so the non-interactive path is covered end-to-end.
Bundled docs and the tracked Clerk skill were updated to match runtime behavior. The command READMEs and skills/clerk/* now describe deterministic agent linking, unlink --yes, and the current agent-mode error semantics instead of documenting the old limitation.

Test plan

bun test packages/cli-core/src/commands/link/index.test.ts packages/cli-core/src/commands/unlink/index.test.ts packages/cli-core/src/test/integration/agent-mode.test.ts packages/cli-core/src/test/integration/onboard.test.ts packages/cli-core/src/test/integration/switch-apps.test.ts
bun run --filter @clerk/cli-core build
Built-JS smoke checks for --version, doctor --json, completion zsh, init --prompt, api ls users, and the new agent-mode link / unlink usage errors
Authenticated manual smoke test against a live Clerk app from this agent environment

changeset-bot · 2026-04-22T17:55:32Z

🦋 Changeset detected

Latest commit: 0644ff1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-04-22T17:59:21Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: dcf489e7-1526-46b4-801f-46a1f2ebb977

📥 Commits

Reviewing files that changed from the base of the PR and between a6f55e5 and 0644ff1.

📒 Files selected for processing (1)

packages/cli-core/src/commands/link/index.ts

🚧 Files skipped from review as they are similar to previous changes (1)

packages/cli-core/src/commands/link/index.ts

📝 Walkthrough

Walkthrough

The PR changes agent-mode behavior for clerk link and clerk unlink. clerk link now runs deterministic non-interactive flows: --app <id> performs a direct fetch-and-link; a bare clerk link will attempt a silent deterministic autolink from detected publishable keys and otherwise throws a usage error instead of prompting. clerk unlink in agent mode requires --yes to proceed; omitting --yes now throws a usage error. Changes touch command implementations, tests (unit and integration), documentation, and skill/reference materials; the previous agent prompt/logging constant was removed and usage-error helpers were added.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'fix(cli-core): support agent-mode link and unlink' clearly and concisely summarizes the main change: adding support for agent-mode operations in the link and unlink commands.
Description check	✅ Passed	The description comprehensively explains the changeset, detailing what changed in link/unlink behavior, integration test coverage updates, and documentation improvements, all directly related to the PR's core objective.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

wyattjoh · 2026-04-22T17:55:28Z

Summary

clerk link and clerk unlink previously hard-returned in agent mode, even when the caller had already provided the flags needed to make the operation deterministic. That kept non-interactive flows like init, onboarding, and app switching from completing end-to-end under an agent harness, and the bundled skills/clerk docs had to document the limitation instead of the intended workflow. This change removes the blanket agent-mode block, preserves the safety checks that actually matter, and updates the skill/docs to match the new behavior.

What changed

link now supports deterministic agent-mode flows. In agent mode, clerk link --app <id> links directly, and the no-flag path first tries silent autolink from detected keys. If the CLI still cannot determine the target app without a picker, it exits with a usage error telling the caller to pass --app or inspect clerk apps list --json.
unlink now works in agent mode with explicit confirmation. The unconditional agent-mode early return is gone. clerk unlink --yes removes the link non-interactively, while omitting --yes now fails with a usage error instead of printing guidance.
The integration coverage now exercises the agent flows that were previously skipped. Agent-mode success/error cases were added for link and unlink, and the previously disabled agent variants of the onboard and switch-app flows are now enabled so the non-interactive path is covered end-to-end.
Bundled docs and the tracked Clerk skill were updated to match runtime behavior. The command READMEs and skills/clerk/* now describe deterministic agent linking, unlink --yes, and the current agent-mode error semantics instead of documenting the old limitation.

Test plan

bun test packages/cli-core/src/commands/link/index.test.ts packages/cli-core/src/commands/unlink/index.test.ts packages/cli-core/src/test/integration/agent-mode.test.ts packages/cli-core/src/test/integration/onboard.test.ts packages/cli-core/src/test/integration/switch-apps.test.ts
bun run --filter @clerk/cli-core build
Built-JS smoke checks for --version, doctor --json, completion zsh, init --prompt, api ls users, and the new agent-mode link / unlink usage errors
Authenticated manual smoke test against a live Clerk app from this agent environment

changeset-bot · 2026-04-22T17:55:32Z

🦋 Changeset detected

Latest commit: 0644ff1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-04-22T17:59:21Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: dcf489e7-1526-46b4-801f-46a1f2ebb977

📥 Commits

Reviewing files that changed from the base of the PR and between a6f55e5 and 0644ff1.

📒 Files selected for processing (1)

packages/cli-core/src/commands/link/index.ts

🚧 Files skipped from review as they are similar to previous changes (1)

packages/cli-core/src/commands/link/index.ts

📝 Walkthrough

Walkthrough

The PR changes agent-mode behavior for clerk link and clerk unlink. clerk link now runs deterministic non-interactive flows: --app <id> performs a direct fetch-and-link; a bare clerk link will attempt a silent deterministic autolink from detected publishable keys and otherwise throws a usage error instead of prompting. clerk unlink in agent mode requires --yes to proceed; omitting --yes now throws a usage error. Changes touch command implementations, tests (unit and integration), documentation, and skill/reference materials; the previous agent prompt/logging constant was removed and usage-error helpers were added.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'fix(cli-core): support agent-mode link and unlink' clearly and concisely summarizes the main change: adding support for agent-mode operations in the link and unlink commands.
Description check	✅ Passed	The description comprehensively explains the changeset, detailing what changed in link/unlink behavior, integration test coverage updates, and documentation improvements, all directly related to the PR's core objective.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

wyattjoh · 2026-04-22T17:55:28Z

Summary

clerk link and clerk unlink previously hard-returned in agent mode, even when the caller had already provided the flags needed to make the operation deterministic. That kept non-interactive flows like init, onboarding, and app switching from completing end-to-end under an agent harness, and the bundled skills/clerk docs had to document the limitation instead of the intended workflow. This change removes the blanket agent-mode block, preserves the safety checks that actually matter, and updates the skill/docs to match the new behavior.

What changed

link now supports deterministic agent-mode flows. In agent mode, clerk link --app <id> links directly, and the no-flag path first tries silent autolink from detected keys. If the CLI still cannot determine the target app without a picker, it exits with a usage error telling the caller to pass --app or inspect clerk apps list --json.
unlink now works in agent mode with explicit confirmation. The unconditional agent-mode early return is gone. clerk unlink --yes removes the link non-interactively, while omitting --yes now fails with a usage error instead of printing guidance.
The integration coverage now exercises the agent flows that were previously skipped. Agent-mode success/error cases were added for link and unlink, and the previously disabled agent variants of the onboard and switch-app flows are now enabled so the non-interactive path is covered end-to-end.
Bundled docs and the tracked Clerk skill were updated to match runtime behavior. The command READMEs and skills/clerk/* now describe deterministic agent linking, unlink --yes, and the current agent-mode error semantics instead of documenting the old limitation.

Test plan

bun test packages/cli-core/src/commands/link/index.test.ts packages/cli-core/src/commands/unlink/index.test.ts packages/cli-core/src/test/integration/agent-mode.test.ts packages/cli-core/src/test/integration/onboard.test.ts packages/cli-core/src/test/integration/switch-apps.test.ts
bun run --filter @clerk/cli-core build
Built-JS smoke checks for --version, doctor --json, completion zsh, init --prompt, api ls users, and the new agent-mode link / unlink usage errors
Authenticated manual smoke test against a live Clerk app from this agent environment

changeset-bot · 2026-04-22T17:55:32Z

🦋 Changeset detected

Latest commit: 0644ff1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-04-22T17:59:21Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: dcf489e7-1526-46b4-801f-46a1f2ebb977

📥 Commits

Reviewing files that changed from the base of the PR and between a6f55e5 and 0644ff1.

📒 Files selected for processing (1)

packages/cli-core/src/commands/link/index.ts

🚧 Files skipped from review as they are similar to previous changes (1)

packages/cli-core/src/commands/link/index.ts

📝 Walkthrough

Walkthrough

The PR changes agent-mode behavior for clerk link and clerk unlink. clerk link now runs deterministic non-interactive flows: --app <id> performs a direct fetch-and-link; a bare clerk link will attempt a silent deterministic autolink from detected publishable keys and otherwise throws a usage error instead of prompting. clerk unlink in agent mode requires --yes to proceed; omitting --yes now throws a usage error. Changes touch command implementations, tests (unit and integration), documentation, and skill/reference materials; the previous agent prompt/logging constant was removed and usage-error helpers were added.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'fix(cli-core): support agent-mode link and unlink' clearly and concisely summarizes the main change: adding support for agent-mode operations in the link and unlink commands.
Description check	✅ Passed	The description comprehensively explains the changeset, detailing what changed in link/unlink behavior, integration test coverage updates, and documentation improvements, all directly related to the PR's core objective.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

wyattjoh · 2026-04-22T17:55:28Z

Summary

clerk link and clerk unlink previously hard-returned in agent mode, even when the caller had already provided the flags needed to make the operation deterministic. That kept non-interactive flows like init, onboarding, and app switching from completing end-to-end under an agent harness, and the bundled skills/clerk docs had to document the limitation instead of the intended workflow. This change removes the blanket agent-mode block, preserves the safety checks that actually matter, and updates the skill/docs to match the new behavior.

What changed

link now supports deterministic agent-mode flows. In agent mode, clerk link --app <id> links directly, and the no-flag path first tries silent autolink from detected keys. If the CLI still cannot determine the target app without a picker, it exits with a usage error telling the caller to pass --app or inspect clerk apps list --json.
unlink now works in agent mode with explicit confirmation. The unconditional agent-mode early return is gone. clerk unlink --yes removes the link non-interactively, while omitting --yes now fails with a usage error instead of printing guidance.
The integration coverage now exercises the agent flows that were previously skipped. Agent-mode success/error cases were added for link and unlink, and the previously disabled agent variants of the onboard and switch-app flows are now enabled so the non-interactive path is covered end-to-end.
Bundled docs and the tracked Clerk skill were updated to match runtime behavior. The command READMEs and skills/clerk/* now describe deterministic agent linking, unlink --yes, and the current agent-mode error semantics instead of documenting the old limitation.

Test plan

bun test packages/cli-core/src/commands/link/index.test.ts packages/cli-core/src/commands/unlink/index.test.ts packages/cli-core/src/test/integration/agent-mode.test.ts packages/cli-core/src/test/integration/onboard.test.ts packages/cli-core/src/test/integration/switch-apps.test.ts
bun run --filter @clerk/cli-core build
Built-JS smoke checks for --version, doctor --json, completion zsh, init --prompt, api ls users, and the new agent-mode link / unlink usage errors
Authenticated manual smoke test against a live Clerk app from this agent environment

changeset-bot · 2026-04-22T17:55:32Z

🦋 Changeset detected

Latest commit: 0644ff1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-04-22T17:59:21Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: dcf489e7-1526-46b4-801f-46a1f2ebb977

📥 Commits

Reviewing files that changed from the base of the PR and between a6f55e5 and 0644ff1.

📒 Files selected for processing (1)

packages/cli-core/src/commands/link/index.ts

🚧 Files skipped from review as they are similar to previous changes (1)

packages/cli-core/src/commands/link/index.ts

📝 Walkthrough

Walkthrough

The PR changes agent-mode behavior for clerk link and clerk unlink. clerk link now runs deterministic non-interactive flows: --app <id> performs a direct fetch-and-link; a bare clerk link will attempt a silent deterministic autolink from detected publishable keys and otherwise throws a usage error instead of prompting. clerk unlink in agent mode requires --yes to proceed; omitting --yes now throws a usage error. Changes touch command implementations, tests (unit and integration), documentation, and skill/reference materials; the previous agent prompt/logging constant was removed and usage-error helpers were added.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'fix(cli-core): support agent-mode link and unlink' clearly and concisely summarizes the main change: adding support for agent-mode operations in the link and unlink commands.
Description check	✅ Passed	The description comprehensively explains the changeset, detailing what changed in link/unlink behavior, integration test coverage updates, and documentation improvements, all directly related to the PR's core objective.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

fix(cli-core): support deterministic agent link flows
201d8ce

chore(release): add changeset for agent link fixes
a6f55e5

wyattjoh requested a review from rafa-thayto April 22, 2026 17:58

rafa-thayto reviewed Apr 22, 2026
View reviewed changes

Comment threadpackages/cli-core/src/commands/link/index.ts Outdated

refactor(link): simplify existing agent branch
0644ff1

wyattjoh requested a review from rafa-thayto April 22, 2026 18:18

rafa-thayto approved these changes Apr 22, 2026
View reviewed changes

wyattjoh merged commit 1e8694c into mainApr 22, 2026
10 checks passed

wyattjoh deleted the wyattjoh/agent-mode-link-unlink branch April 22, 2026 18:19

github-actionsBot mentioned this pull request Apr 22, 2026
ci(repo): Version Packages #181
Merged