Skip to content

appfigures/cli

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
.github/workflows
.github/workflows
 
 
bin
bin
 
 
dist
dist
 
 
CHANGELOG.md
CHANGELOG.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
package.json
package.json
 
 

Repository files navigation

@appfigures/cli

npm

The Appfigures CLI — query app metrics, reviews, and store data from your terminal.

Try it now without installing:

npx @appfigures/cli auth login
npx @appfigures/cli apps search "youtube"

Install

npm install -g @appfigures/cli

Requires Node.js 22+. Works with pnpm and yarn too.

Quick start

appfigures auth login
appfigures --help

Also available as af alias.

Authentication

Run af auth login in an interactive terminal to sign in. Two ways:

  • Browser (default): opens your browser, approve, paste the code shown back into the CLI. The resulting token is stored in your OS credential manager (macOS Keychain, Windows Credential Manager, Linux Secret Service).
  • Personal access token: pick "Personal access token" at the prompt for instructions. Create a token at appfigures.com/developers/keys, then export APPFIGURES_API_KEY=<your-token>.

For CI or any non-interactive context, af auth login will not run — see Environment below.

Built for agents

Designed to be driven by LLM agents as much as by humans.

  • JSON on stdout, everything else on stderr. Every command emits a single JSON value on stdout — jq-ready, no interleaved logs, hints, or update notices.
  • Agent mode by default. Compact JSON, agent-directed NOTE: hints on stderr, no prompts or spinners; pass --human for interactive use.
  • Self-describing, offline. af docs get catalog_playbook and af docs get numeric_metrics print the full query grammar and dataset catalog without hitting the API — plan queries without round-trips or stale training data.
  • Unattended auth. Set APPFIGURES_API_KEY in the environment; every command runs without a browser or prompt.
  • Raw API escape hatch. af api <path> proxies any endpoint the first-class commands don't cover.

MCP server

af mcp runs a local Model Context Protocol server over stdio, exposing the CLI's app-intelligence commands as MCP tools. Point any MCP client (Claude Desktop, Cursor, and others) at it to let an agent query app metrics, reviews, and store data directly.

Add it to your client's MCP config:

{
	"mcpServers": {
		"appfigures": {
			"command": "npx",
			"args": ["-y", "@appfigures/cli", "mcp"]
		}
	}
}

The server signs in with your stored credentials, so run af auth login once first. For a headless setup, pass a token through the client's env instead:

{
	"mcpServers": {
		"appfigures": {
			"command": "npx",
			"args": ["-y", "@appfigures/cli", "mcp"],
			"env": { "APPFIGURES_API_KEY": "<your-token>" }
		}
	}
}

Installed the CLI globally instead of running it through npx? Use "command": "af" with "args": ["mcp"].

Commands

Apps

Find apps and look up their identity. Other commands take the app IDs these return.

Command Description
af apps search Find apps by name or publisher. Returns one row per unified app. Default returns Apple and Google listings; pass --all-stores to include other storefronts. To filter apps by estimate values (e.g. apps with >100k downloads last month) use explorer query. For estimates broken down by time, country, or storefront, use metrics query with datasets estimates.sales or estimates.revenue.
af apps tracked List the apps your Appfigures account tracks.
af apps get Get an app's record: basic metadata (name, developer, etc) and, if the user tracks it, what data they can access. Pass a product ID for one storefront; unified app ID for all storefronts together.

Explorer

Search and analyze the app catalog: 3M+ apps and 120+ fields spanning identity, storefront and country availability, categories, ratings, release dates, chart ranks, download and revenue estimates, SDK presence, demographics, and related apps.

Command Description
af explorer query Read catalog fields for one app or many. Fields referenced by query or sort come back automatically; pass --extra-fields for more. Use ["match","product_id",<id>] for a single app, or combine filters for population queries (e.g. iOS apps using Firebase with $1M+ US revenue). The 120+ fields span ranks, ratings, download and revenue estimates, SDKs, demographics, and more; query grammar and field list in docs get catalog_playbook.
af explorer aggregate Aggregate across the 3M-app catalog: counts, averages, min/max, and histograms over any set of matching apps. Uses the same bespoke JSON query grammar as explorer query; returns aggregates, not app records. For market sizing, benchmarking, and segment analysis.
af explorer fields List the catalog fields and the current user's access level for each. Same field set explorer query and explorer aggregate accept. Pass --q to search the catalog by keyword.

Metrics

Query numeric datasets across dimensions.

Command Description
af metrics query Query any numeric dataset for one or more apps. Optionally grouped by up to two dimensions, returned as a nested partition tree, not app records. Independently filterable by country, device type, and date range. filterAppsBy* options narrow the app set (by ID, storefront, source, or type). Some datasets require app ownership; others work for any app (with the right plan).

Store

App store presence: listing content, category ranks, top charts, and featured placements.

Command Description
af store app‑ranks Trace rank history for one or more apps across countries, device types, category subtypes, and categories, as time-series positions with day-over-day deltas.
af store top‑charts List the top apps in a category chart for a given country and category, with current positions and day-over-day deltas.
af store categories List every store category with its ID. Numeric category IDs required by store app-ranks --category-ids and store top-charts --category-id are available here.
af store featured List featured and editorial placements for an app or storefront product. Pass --count=0 for summary stats only.
af store app‑listing Read the full store listing for one storefront: localized text (name, subtitle, description, release notes) plus screenshots, video, categories, monetization, supported devices, country availability, price, file size, and age rating. Takes a numeric product ID (one storefront at a time; a unified app has one product per storefront). One locale per request.

Reviews

Search, summarize, and reply to iOS and Google Play app store reviews.

Command Description
af reviews list Read individual reviews for one or more apps. Returns review text, star rating, country, and app version. Filterable by star rating, date range, country, version, and tracking relationship.
af reviews breakdown Aggregate review counts for one or more apps, bucketed by dimension. Returns one count per dimension value, plus a global total across the matched set.
af reviews reply Post or withdraw a developer response on a specific review. Pass content to post; pass delete: true to withdraw a previously-posted response. Returns the resulting state (published/pending for a post, removed/removal_pending for a withdrawal) along with the submitting account.

Keywords

Organic keyword visibility and tracking.

Command Description
af keywords list List tracked keywords with their opaque IDs.
af keywords rankings Check the organic keywords one or more apps rank for, with position, popularity, and competitiveness.
af keywords results List the apps ranking for a specific keyword in organic search, plus the keyword's own popularity and competitiveness scores.
af keywords related Find keywords related to a seed term for ASO research. Useful for finding alternatives with a similar audience that are more popular or less competitive.

Apple Ads

Apple Search Ads intelligence.

Command Description
af apple‑ads keywords List the paid keywords one or more apps run ads on, with impression share and organic rank.
af apple‑ads advertisers List the apps advertising on a specific keyword, with each advertiser's impression share, organic rank, and how long they've been bidding.

Sdks

Look up canonical SDK IDs by name across the SDKs Appfigures tracks. The IDs are the values explorer query accepts as SDK filters.

Command Description
af sdks list List every known SDK with its id. Use the id to filter apps by SDK in explorer query.

Docs

Reference docs and guides for specific actions and common tasks.

Command Description
af docs get Return a reference doc or guide by slug.

API

Command Description
af api Make a raw API request for endpoints without a dedicated command. Endpoints, parameters, and response shapes are documented at https://docs.appfigures.com.

MCP

Command Description
af mcp Run an MCP server over stdio for MCP clients like Claude Desktop and Cursor to call Appfigures tools.

Auth

Command Description
af auth login Sign in to Appfigures
af auth logout Remove stored credentials
af auth status Show authentication and account status

Run af <command> --help for arguments, flags, and examples.

Environment

Variable Purpose
APPFIGURES_API_KEY API key; skips interactive auth
AF_VERBOSE Log HTTP to stderr (same as -v)
NO_COLOR Disable ANSI color
NO_UPDATE_NOTIFIER Skip the npm-registry update check
CI Also skips the update check (any CI system)

API Reference

Every command with its full argument and flag list. For the one-line overview, see Commands above.

Global flags. All commands accept:

  • -v, --verbose — Log HTTP requests to stderr. Also set via AF_VERBOSE=1.
  • -V, --version — Print the CLI version and exit.
  • -h, --help — Show usage for the current command.

Output format. Every command emits a single JSON value on stdout — pipe to jq for filtering. Informational messages, hints, and update notices go to stderr so pipelines stay clean.

af apps search

af apps search <query> [flags]

Find apps by name or publisher. Returns one row per unified app. Default returns Apple and Google listings; pass --all-stores to include other storefronts. To filter apps by estimate values (e.g. apps with >100k downloads last month) use explorer query. For estimates broken down by time, country, or storefront, use metrics query with datasets estimates.sales or estimates.revenue.

Options

  • <query> required string. Search query (app name or publisher).
  • --all-stores boolean, default false. Include storefronts beyond Apple and Google: Amazon, Windows, Steam, Roku, LG TV, Samsung TV, and others.
  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.

af apps tracked

af apps tracked [flags]

List the apps your Appfigures account tracks.

Options

  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.
  • --q string. App name to filter by.
  • --filter-apps-by-id (integer or string)[]. Only include data about specific apps, by product ID or unified app ID. Takes precedence over the other filterAppsBy* keys when set. Storefront, source, or type filters are better for app sets that can be described by those criteria.
  • --filter-apps-by-storefront string[]. Narrow the account's tracked apps to those on these storefronts (e.g. apple:ios, google_play).
  • --filter-apps-by-source string[]. Narrow the account's tracked apps by tracking relationship.
  • --filter-apps-by-type string[]. Narrow the account's tracked apps to products of these types.

af apps get

af apps get <app-id> [flags]

Get an app's record: basic metadata (name, developer, etc) and, if the user tracks it, what data they can access. Pass a product ID for one storefront; unified app ID for all storefronts together.

Options

  • <app-id> required integer or string. App identifier. Unified app ID or product ID.
  • --all-stores boolean, default false. For a unified app ID: include member products across all storefronts (Amazon, Steam, Windows, Roku, etc.). When false, member_products is restricted to storefronts with app-intelligence coverage (iOS + Google Play). Ignored for product IDs.

af explorer query

af explorer query [query] [flags]

Read catalog fields for one app or many. Fields referenced by query or sort come back automatically; pass --extra-fields for more. Use ["match","product_id",<id>] for a single app, or combine filters for population queries (e.g. iOS apps using Firebase with $1M+ US revenue). The 120+ fields span ranks, ratings, download and revenue estimates, SDKs, demographics, and more; query grammar and field list in docs get catalog_playbook.

Options

  • [query] array. Explorer query in JSON array format to select matching catalog Products. Missing values and [] match every Product across every storefront. The full field list and query syntax are documented in docs get catalog_playbook.
  • --extra-fields string[]. Additional fields to include. The full field list is documented in docs get catalog_playbook.
  • --sort string. Explorer field name. The full field list is documented in docs get catalog_playbook.
  • --order string, default desc. Sort direction.
  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.
  • --allow-unscoped-nested boolean, default false. Escape hatch for intentionally broad queries. Bypasses the default block on unscoped nested predicates that usually inflate results.

af explorer aggregate

af explorer aggregate <fields> [flags]

Aggregate across the 3M-app catalog: counts, averages, min/max, and histograms over any set of matching apps. Uses the same bespoke JSON query grammar as explorer query; returns aggregates, not app records. For market sizing, benchmarking, and segment analysis.

Options

  • --query array. Explorer query in JSON array format to select matching catalog Products. Missing values and [] match every Product across every storefront. The full field list and query syntax are documented in docs get catalog_playbook.
  • <fields> required string[]. Field+aggregation pairs (e.g. all_rating/stats, storefronts/terms). Aggregations: stats, terms, histogram, date_histogram, cardinality. The full field list is documented in docs get catalog_playbook.
  • --allow-unscoped-nested boolean, default false. Escape hatch for intentionally broad queries. Bypasses the default block on unscoped nested predicates that usually inflate results.
  • --terms-count integer, default 20. Maximum buckets returned for each terms aggregation. Other aggregation types ignore it.

af explorer fields

af explorer fields [flags]

List the catalog fields and the current user's access level for each. Same field set explorer query and explorer aggregate accept. Pass --q to search the catalog by keyword.

Options

  • --count integer, default 50. Number of results to return
  • --page integer, default 1. Page number.
  • --q string. Fuzzy string match on path, title, description, type.

af metrics query

af metrics query <dataset> [flags]

Query any numeric dataset for one or more apps. Optionally grouped by up to two dimensions, returned as a nested partition tree, not app records. Independently filterable by country, device type, and date range. filterAppsBy* options narrow the app set (by ID, storefront, source, or type). Some datasets require app ownership; others work for any app (with the right plan).

Options

  • <dataset> required string. Dataset to query (e.g. sales.combined_downloads). The full list is documented in docs get numeric_metrics.
  • --group-by string[]. Dimensions to group by. Max 2: the first slot becomes the outer entity type, the second the inner series.
  • --granularity string. Time granularity when grouping by date
  • --count integer. Row cap. With --group-by, top N of the outer entity type by value (earliest N when grouping by date). Without --group-by, single-page preview.
  • --countries string[]. Filter to one or more ISO country codes (e.g. US, JP, GB)
  • --device-type string. Device type
  • --all-time boolean, default false. Opt in to the entire history. Without this flag (and without start/end), the query defaults to the last 30 days. Mutually exclusive with start and end.
  • --filter-apps-by-id (integer or string)[]. Only include data about specific apps, by product ID or unified app ID. Takes precedence over the other filterAppsBy* keys when set. Storefront, source, or type filters are better for app sets that can be described by those criteria.
  • --filter-apps-by-storefront string[]. Narrow the account's tracked apps to those on these storefronts (e.g. apple:ios, google_play).
  • --filter-apps-by-source string[]. Narrow the account's tracked apps by tracking relationship.
  • --filter-apps-by-type string[]. Narrow the account's tracked apps to products of these types.
  • --start string. Start date (YYYY-MM-DD)
  • --end string. End date (YYYY-MM-DD, defaults to today)

af store app-ranks

af store app-ranks <app-ids> [flags]

Trace rank history for one or more apps across countries, device types, category subtypes, and categories, as time-series positions with day-over-day deltas.

Options

  • <app-ids> required (integer or string)[]. App identifiers (unified app IDs or product IDs)
  • --countries string[]. Country codes to query. Defaults to every country with rank coverage.
  • --granularity string, default hourly. Sampling rate. Hourly gives the freshest data; pass --granularity=daily for compact multi-day history.
  • --device-types string[], default ["handheld"]. Filter response rows by device type.
  • --subtypes string[], default ["free"]. Filter response rows by category subtype.
  • --category-ids integer[]. Filter response rows by category ID.
  • --start string. Start date (YYYY-MM-DD)
  • --end string. End date (YYYY-MM-DD, defaults to today)
  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.

af store top-charts

af store top-charts [flags]

List the top apps in a category chart for a given country and category, with current positions and day-over-day deltas.

Options

  • --country required string. ISO country code (e.g. US, JP, GB)
  • --category-id required integer. Store category ID
  • --subtype string, default free. Category subtype (chart variant within the category).
  • --date string. Snapshot date (YYYY-MM-DD, defaults to current).
  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.

af store categories

af store categories [flags]

List every store category with its ID. Numeric category IDs required by store app-ranks --category-ids and store top-charts --category-id are available here.

Options

  • --count integer, default 50. Number of results to return
  • --page integer, default 1. Page number.
  • --q string. Fuzzy string match on name.
  • --sort-by string. Sort order. Default: relevance when q is set, otherwise list order.
  • --id integer[]. Only return these category IDs.
  • --parent-id integer. Only include subcategories of this parent category (drill-down by id).
  • --storefront string[]. Only include categories from these storefronts (e.g. apple:ios, google_play).
  • --device-type string[]. Only include categories for these device types (e.g. handheld, tablet).
  • --all boolean, default false. Include non-rank stores (roku, vizio, etc.). These have categories but no rank data.

af store featured

af store featured <app-id> [flags]

List featured and editorial placements for an app or storefront product. Pass --count=0 for summary stats only.

Options

  • <app-id> required integer or string. App identifier. Unified app ID or product ID.
  • --countries string[]. Countries to include. Pass multiple countries to compare markets; omit when using --all-countries.
  • --all-countries boolean, default false. Include every country by omitting the --countries filter.
  • --include-rank-trend boolean, default false. Include per-interval rank_trend for each placement.
  • --sort string, default relevance. Sort placements by relevance or date.
  • --order string, default desc. Sort direction.
  • --start string. Start date (YYYY-MM-DD)
  • --end string. End date (YYYY-MM-DD, defaults to today)
  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.

af store app-listing

af store app-listing <product-id> [flags]

Read the full store listing for one storefront: localized text (name, subtitle, description, release notes) plus screenshots, video, categories, monetization, supported devices, country availability, price, file size, and age rating. Takes a numeric product ID (one storefront at a time; a unified app has one product per storefront). One locale per request.

Options

  • <product-id> required integer. Numeric product ID for one storefront. Not a unified app ID. Member product_id values are available from apps get '<unified-app-id>'.
  • --language string. Locale (e.g. en, ja, zh-Hans) for name, subtitle, description, release notes, and screenshots. Defaults to en; falls back to the first available locale when the requested one has no metadata. The response echoes the resolved language.
  • --device-type string, default handheld. Relevant to Apple apps. Pick handheld for iPhone-specific metadata, tablet for iPad, desktop for Mac, etc.

af reviews list

af reviews list [flags]

Read individual reviews for one or more apps. Returns review text, star rating, country, and app version. Filterable by star rating, date range, country, version, and tracking relationship.

Options

  • --stars number[]. Filter by star rating.
  • --versions string[]. Filter by app version. Pass multiple to combine.
  • --countries string[]. Filter to one or more ISO country codes (e.g. US, JP, GB).
  • --q string. Search review title and body. Pass multiple keywords to match any. Case-insensitive; combines with other filters.
  • --sort string. Sort by review date or star rating.
  • --order string, default desc. Sort direction.
  • --filter-apps-by-id (integer or string)[]. Only include data about specific apps, by product ID or unified app ID. Takes precedence over the other filterAppsBy* keys when set. Storefront, source, or type filters are better for app sets that can be described by those criteria.
  • --filter-apps-by-storefront string[]. Narrow the account's tracked apps to those on these storefronts (e.g. apple:ios, google_play).
  • --filter-apps-by-source string[]. Narrow the account's tracked apps by tracking relationship.
  • --filter-apps-by-type string[]. Narrow the account's tracked apps to products of these types.
  • --start string. Start date (YYYY-MM-DD)
  • --end string. End date (YYYY-MM-DD, defaults to today)
  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number. 1-500.

af reviews breakdown

af reviews breakdown [flags]

Aggregate review counts for one or more apps, bucketed by dimension. Returns one count per dimension value, plus a global total across the matched set.

Options

  • --stars number[]. Filter by star rating.
  • --versions string[]. Filter by app version. Pass multiple to combine.
  • --countries string[]. Filter to one or more ISO country codes (e.g. US, JP, GB).
  • --q string. Search review title and body. Pass multiple keywords to match any. Case-insensitive; combines with other filters.
  • --filter-apps-by-id (integer or string)[]. Only include data about specific apps, by product ID or unified app ID. Takes precedence over the other filterAppsBy* keys when set. Storefront, source, or type filters are better for app sets that can be described by those criteria.
  • --filter-apps-by-storefront string[]. Narrow the account's tracked apps to those on these storefronts (e.g. apple:ios, google_play).
  • --filter-apps-by-source string[]. Narrow the account's tracked apps by tracking relationship.
  • --filter-apps-by-type string[]. Narrow the account's tracked apps to products of these types.
  • --start string. Start date (YYYY-MM-DD)
  • --end string. End date (YYYY-MM-DD, defaults to today)

af reviews reply

af reviews reply <review-id> [flags]

Post or withdraw a developer response on a specific review. Pass content to post; pass delete: true to withdraw a previously-posted response. Returns the resulting state (published/pending for a post, removed/removal_pending for a withdrawal) along with the submitting account.

Options

  • <review-id> required string. Review to act on. Use review_id from reviews list.
  • --content string. Response text the developer wants to publish.
  • --delete boolean. Withdraw the previously-posted response on this review. Mutually exclusive with content.

af keywords list

af keywords list [flags]

List tracked keywords with their opaque IDs.

Options

  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.
  • --q string. Fuzzy string match on keyword_term.
  • --sort-by string. Sort order. Default: relevance when q is set, otherwise list order.
  • --include-relationships boolean, default false. Include per-(product, country) tracking detail and sync state on each row. Off by default; adds a nested block per tracked (product, country) pair.

af keywords rankings

af keywords rankings [flags]

Check the organic keywords one or more apps rank for, with position, popularity, and competitiveness.

Options

  • --product-ids integer[]. Product identifiers (numeric, one storefront each).
  • --country required string. ISO country code (e.g. US, JP, GB)
  • --device-type string. Device type
  • --count integer, default 10. Number of results to return (min 10).
  • --page integer, default 1. Page number.

af keywords results

af keywords results <keyword-name> [flags]

List the apps ranking for a specific keyword in organic search, plus the keyword's own popularity and competitiveness scores.

Options

  • <keyword-name> required string. Keyword to look up.
  • --country required string. ISO country code (e.g. US, JP, GB)
  • --storefront required string. App store platform (e.g. apple:ios, google_play, amazon_appstore, steam, windows10, apple:mac, apple:tv, apple:imessage, or another supported storefront).
  • --device-type string. Device type
  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.

af keywords related

af keywords related <keyword-name> [flags]

Find keywords related to a seed term for ASO research. Useful for finding alternatives with a similar audience that are more popular or less competitive.

Options

  • <keyword-name> required string. Seed keyword to find related terms for.
  • --country string. ISO country code (e.g. US, JP, GB)
  • --storefront string. App store platform (e.g. apple:ios, google_play, amazon_appstore, steam, windows10, apple:mac, apple:tv, apple:imessage, or another supported storefront).
  • --device-type string. Device type
  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.

af apple-ads keywords

af apple-ads keywords <product-ids> [flags]

List the paid keywords one or more apps run ads on, with impression share and organic rank.

Options

  • <product-ids> required integer[]. Product identifiers (numeric, one storefront each).
  • --days integer, default 180. Lookback period in days. Common values: 7, 14, 30, 90, 180, 365.
  • --country string. ISO country code (e.g. US, JP, GB)
  • --device-type string. Device type
  • --count integer, default 10. Number of results to return (min 10).
  • --page integer, default 1. Page number.

af apple-ads advertisers

af apple-ads advertisers <keyword-name> [flags]

List the apps advertising on a specific keyword, with each advertiser's impression share, organic rank, and how long they've been bidding.

Options

  • <keyword-name> required string. Keyword to look up advertisers for
  • --days integer, default 180. Lookback period in days. Common values: 7, 14, 30, 90, 180, 365.
  • --country string. ISO country code (e.g. US, JP, GB)
  • --device-type string. Device type
  • --count integer, default 10. Number of results to return
  • --page integer, default 1. Page number.

af sdks list

af sdks list [flags]

List every known SDK with its id. Use the id to filter apps by SDK in explorer query.

Options

  • --count integer, default 50. Number of results to return
  • --page integer, default 1. Page number.
  • --q string. Fuzzy string match on name, description, tags.
  • --sort-by string. Sort order. Default: relevance when q is set, otherwise list order.
  • --id string[]. Only return these SDK ids.
  • --include-inactive boolean, default false. Include inactive SDKs. Rare; most callers want active only.

af docs get

af docs get <slug>

Return a reference doc or guide by slug.

Options

  • <slug> required string. Which reference to return

af api

af api <path> [flags]

Make a raw API request for endpoints without a dedicated command. Endpoints, parameters, and response shapes are documented at https://docs.appfigures.com.

Options

  • <path> required string. API path (e.g. /users, /products)
  • --method string, default GET. HTTP method (one of: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)
  • --body string. Request body (JSON string)

af mcp

af mcp

Run an MCP server over stdio for MCP clients like Claude Desktop and Cursor to call Appfigures tools.

af auth login

af auth login [flags]

Sign in to Appfigures

Prints a URL to authorize this CLI. Open it, approve access, then re-run with --code <code> using the code shown after approval.

For unattended use (CI, scripts), set APPFIGURES_API_KEY in the environment instead. No browser flow needed.

Options

  • --code string. Authorization code from the OAuth consent page. Second step of af auth login: exchanges the code, saves the token, exits.

af auth logout

af auth logout

Remove stored credentials

af auth status

af auth status

Show authentication and account status

Support

Contributing

This package is developed in a private monorepo and published here as a mirror. To report bugs or request features, open an issue.

We're also hiring AI-native devs. If you want to help build the future of AI App Intelligence apply at appfigures.com/careers.

License

Apache 2.0

About

The official Appfigures CLI

Resources

Readme

License

Apache-2.0 license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 6

@appfigures/cli v1.0.0-beta.7 Latest
Jun 1, 2026
+ 5 releases

Packages

 
 
 

Contributors

Languages