skills.rest
adaptyteam
adaptyteamOFFICIAL
Explore all skills by this author →
Website𝕏@adaptyGitHub

adapty-cli-setup

Installs and authenticates the Adapty CLI and connects Apple Search Ads accounts.

Updated Aug 16, 2026
Search Tags:#authentication#sandbox#cli setup#npm install#apple search ads#device code login#adapty cli
One-click install
npx skills add https://github.com/adaptyteam/apple-ads-cli --skill adapty-cli-setup-adaptyteam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adapty-cli-setup
Source: https://github.com/adaptyteam/apple-ads-cli/tree/main/skills/adapty-cli-setup
Command: npx skills add https://github.com/adaptyteam/apple-ads-cli --skill adapty-cli-setup-adaptyteam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires adapty.

What problem does it solve? Cloud and sandboxed agent sessions start on a clean machine with no CLI, no token, and no config, so any Apple Search Ads work fails immediately with "command not found" or AuthRequiredError. This Skill takes a blank session to a fully authenticated Adapty CLI with an Apple Search Ads account connected, without guessing at install or login steps. ## Core Features & Use Cases - Automated install and auth flow: Two copy-paste bash blocks install adapty@latest (with EACCES fallback to a user prefix), start the device-code login, and poll authentication state, ending in explicit status lines like READY_AUTHED, NEED_AUTH, AUTHED, or EXPIRED. - Apple Search Ads connection: Runs adapty asa connect (with --no-wait when the authorizer is a different person) and confirms via adapty asa whoami that Apple credentials are active for the company. - Failure-mode triage: A lookup table distinguishes real setup failures (Node too old, npm registry blocked, missing PATH) from non-issues like 402 subscription-required, NetworkError, or macOS Keychain -25291 noise, preventing pointless reinstalls. - Use Case: In a fresh Claude Cowork session, a user asks to check Apple Ads spend; the agent detects the CLI is missing, runs the setup blocks, surfaces the auth link and code, waits for approval, connects Apple, and hands off to the apple-ads skill. ## Quick Start Ask the agent to install and authenticate the Adapty CLI and connect your Apple Search Ads account in this session.

Frequently Asked Questions about adapty-cli-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install and authenticate the Adapty CLI in a cloud session?▼

Run npm install -g adapty@latest, then start adapty auth login in the background to mint a device code. Surface the printed URL and code to the user immediately, then poll adapty asa whoami until it returns account details.

How do I connect an Apple Search Ads account to the Adapty CLI?▼

Run adapty asa connect, which prints an Apple authorization link and waits. Use adapty asa connect --no-wait when a different person will authorize, then confirm with adapty asa whoami that Apple Credentials Status is active.

Why does adapty auth login fail in Claude Cowork or a sandbox?▼

Sandboxes block network egress by default, so npm install and API calls fail. Enable code execution and network egress, allowlist both adapty.io and *.adapty.io, then start a new task because settings only apply when a task starts.

What does the 402 ads_manager_subscription_required error mean?▼

It means authentication succeeded but the company has no Ads Manager subscription or trial. It is not a setup bug, so do not reinstall or log in again; report it plainly and stop, since no flag bypasses it.

Why does adapty asa whoami fail after a successful login?▼

A stale ADAPTY_TOKEN environment variable overrides the stored config and silently wins when set. Unset ADAPTY_TOKEN and re-check; also note the token dies with the shell, so it must be exported in the same process.

Can this skill run Apple Search Ads campaign changes after setup?▼

No. This skill is read-only setup plus asa connect; it never runs write commands. Once whoami shows active Apple credentials, it hands off to the apple-ads skill, which owns bid, budget, and keyword writes.

Related Skills

Explore More Marketing & Sales Skills→
castaricastari
7

castari-deploy

Deploys your agent to the cloud with one click.

Official
Intermediate
TrebuhSTrebuhS
5

Apple-Search-Ads

Manage Apple Search Ads campaigns, keywords, and reports via asa-cli.

Community
Intermediate
dustinober1dustinober1

asc-apple-ads

Manages Apple Ads campaigns, keywords, and reports through the asc CLI.

Community
Intermediate
rudrankriyamrudrankriyam
1.0k

asc-apple-ads

Manages Apple Ads campaigns, targeting, reports, and assets through the asc CLI Platform API v1.

Community
Advanced