@emergentmethods/asknews-cli 0.1.0

package/skills/asknews-cli/references/commands/api-newsletters.md

@@ -0,0 +1,236 @@
+# api newsletters
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api newsletters delete-newsletter`
+
+Delete a newsletter.
+
+- Request: `DELETE /v1/chat/newsletters/{newsletter_id}`
+- Operation ID: `delete_newsletter`
+- Safety: `mutating`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--newsletter-id` | The newsletter ID Location: path. Type: string. Required. Format: uuid. |
+
+This operation requires confirmation and `--yes` in non-interactive use.
+
+### `asknews api newsletters delete-newsletter-contact`
+
+Delete a newsletter contact.
+
+- Request: `DELETE /v1/chat/newsletters/{newsletter_id}/contacts/{contact_id}`
+- Operation ID: `delete_newsletter_contact`
+- Safety: `mutating`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--newsletter-id` | The newsletter ID Location: path. Type: string. Required. Format: uuid. |
+| `--contact-id` | The contact ID Location: path. Type: string. Required. |
+
+This operation requires confirmation and `--yes` in non-interactive use.
+
+### `asknews api newsletters get-newsletter`
+
+Get a newsletter.
+
+- Request: `GET /v1/chat/newsletters/{newsletter_id}`
+- Operation ID: `get_newsletter`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--newsletter-id` | The newsletter ID Location: path. Type: string. Required. Format: uuid. |
+
+### `asknews api newsletters get-newsletter-contact`
+
+Get a newsletter contact.
+
+- Request: `GET /v1/chat/newsletters/{newsletter_id}/contacts/{contact_id}`
+- Operation ID: `get_newsletter_contact`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--newsletter-id` | The newsletter ID Location: path. Type: string. Required. Format: uuid. |
+| `--contact-id` | The contact ID Location: path. Type: string. Required. |
+
+### `asknews api newsletters get-newsletter-contacts`
+
+Get newsletter contacts.
+
+- Request: `GET /v1/chat/newsletters/{newsletter_id}/contacts`
+- Operation ID: `get_newsletter_contacts`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--newsletter-id` | The newsletter ID Location: path. Type: string. Required. Format: uuid. |
+
+### `asknews api newsletters get-newsletters`
+
+Get all created newsletters.
+
+- Request: `GET /v1/chat/newsletters`
+- Operation ID: `get_newsletters`
+- Safety: `read-only`
+
+### `asknews api newsletters get-public-newsletters`
+
+Get all public newsletters.
+
+- Request: `GET /v1/chat/newsletters/public`
+- Operation ID: `get_public_newsletters`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--page` | The page number to get Location: query. Type: integer. Optional. Default: `1`. |
+| `--per-page` | The number of items per page Location: query. Type: integer. Optional. Default: `10`. |
+| `--all` | Whether to get all the public newsletters Location: query. Type: boolean. Optional. Default: `false`. |
+
+### `asknews api newsletters patch-newsletter-contact`
+
+Update a newsletter contact.
+
+- Request: `PATCH /v1/chat/newsletters/{newsletter_id}/contacts/{contact_id}`
+- Operation ID: `patch_newsletter_contact`
+- Safety: `mutating`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--newsletter-id` | The newsletter ID Location: path. Type: string. Required. Format: uuid. |
+| `--contact-id` | The contact ID Location: path. Type: string. Required. |
+
+**Request body fields:**
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--email` | string | yes |  |
+| `--first-name` | string or null | no |  |
+| `--last-name` | string or null | no |  |
+| `--unsubscribed` | boolean | no | Default: `false`. |
+
+Use direct kebab-case body options, `--body '{...}'`, or `--body @request.json`.
+Direct body options override values supplied through `--body`.
+
+This operation requires confirmation and `--yes` in non-interactive use.
+
+### `asknews api newsletters post-newsletter`
+
+Create a newsletter.
+
+- Request: `POST /v1/chat/newsletters`
+- Operation ID: `post_newsletter`
+- Safety: `mutating`
+
+**Request body fields:**
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--name` | string | yes | The name of the newsletter. |
+| `--query` | string | yes | The natural language query to run for the newsletter. |
+| `--cron` | string | yes | The cron schedule for the newsletter. For example daily at 00:00 UTC is '0 0 * * *'. See https://crontab.run/ for more examples |
+| `--model` | string | yes | The model to use for the newsletter. Choices: gpt-4o, gpt-4o-mini, claude-3-5-sonnet-latest, meta-llama/Meta-Llama-3.1-405B-Instruct, meta-llama/Meta-Llama-3.3-70B-Instruct. |
+| `--subject` | string or null | no | The subject of the newsletter. If not provided it will be auto generated. |
+| `--sender` | string | yes | The sender of the newsletter. |
+| `--logo-url` | string or null | no | The logo URL for the newsletter. |
+| `--reply-to` | string or null | no | The reply-to address for the newsletter. If not provided, the sender will be used. |
+| `--audience-id` | string or null | no | The audience ID to use for the newsletter. If not provided a new audience will be created. |
+| `--resend-api-key` | string or null | no | The resend API key to use for the newsletter. If not provided, the newsletter will not be sent. |
+| `--public` | boolean | no | Whether the newsletter is public or not. If not provided, the newsletter will be public. If you make the newsletter public only title and query will be shown. Default: `true`. |
+| `--active` | boolean | no | Whether the newsletter is active or not. If not provided, the newsletter will be active. If you make the newsletter inactive, it will not be sent. Default: `true`. |
+| `--expires-at` | string or null | no | The expiration date for the alert. Default is None. If set, the alert will be disabled after this date. |
+
+Use direct kebab-case body options, `--body '{...}'`, or `--body @request.json`.
+Direct body options override values supplied through `--body`.
+
+This operation requires confirmation and `--yes` in non-interactive use.
+
+### `asknews api newsletters post-newsletter-contacts`
+
+Create a newsletter contact.
+
+- Request: `POST /v1/chat/newsletters/{newsletter_id}/contacts`
+- Operation ID: `post_newsletter_contacts`
+- Safety: `mutating`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--newsletter-id` | The newsletter ID Location: path. Type: string. Required. Format: uuid. |
+
+**Request body fields:**
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--email` | string | yes |  |
+| `--first-name` | string or null | no |  |
+| `--last-name` | string or null | no |  |
+| `--unsubscribed` | boolean | no | Default: `false`. |
+
+Use direct kebab-case body options, `--body '{...}'`, or `--body @request.json`.
+Direct body options override values supplied through `--body`.
+
+This operation requires confirmation and `--yes` in non-interactive use.
+
+### `asknews api newsletters put-newsletter`
+
+Update a newsletter.
+
+- Request: `PUT /v1/chat/newsletters/{newsletter_id}`
+- Operation ID: `put_newsletter`
+- Safety: `mutating`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--newsletter-id` | The newsletter ID Location: path. Type: string. Required. Format: uuid. |
+
+**Request body fields:**
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--name` | string or null | no | The name of the newsletter. |
+| `--query` | string or null | no | The natural language query to run for the newsletter. |
+| `--cron` | string or null | no | The cron schedule for the newsletter. For example daily at 00:00 UTC is '0 0 * * *'. See https://crontab.run/ for more examples |
+| `--model` | string or null | no | The model to use for the newsletter. |
+| `--subject` | string or null | no | The subject of the newsletter. If not provided it will be auto generated. |
+| `--sender` | string or null | no | The sender of the newsletter. |
+| `--logo-url` | string or null | no | The logo URL for the newsletter. |
+| `--reply-to` | string or null | no | The reply-to address for the newsletter. If not provided, the sender will be used. |
+| `--audience-id` | string or null | no | The audience ID to use for the newsletter. If not provided a new audience will be created. |
+| `--resend-api-key` | string or null | no | The resend API key to use for the newsletter. If not provided, the newsletter will not be sent. |
+| `--public` | boolean or null | no | Whether the newsletter is public or not. If not provided, the newsletter will be public. If you make the newsletter public only title and query will be shown. |
+| `--active` | boolean or null | no | Whether the newsletter is active or not. If not provided, the newsletter will be active. If you make the newsletter inactive, it will not be sent. |
+| `--expires-at` | string or null | no | The expiration date for the alert. Default is None. If set, the alert will be disabled after this date. |
+
+Use direct kebab-case body options, `--body '{...}'`, or `--body @request.json`.
+Direct body options override values supplied through `--body`.
+
+This operation requires confirmation and `--yes` in non-interactive use.
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-ping.md

@@ -0,0 +1,19 @@
+# api ping
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api ping ping`
+
+Ping
+
+- Request: `GET /`
+- Operation ID: `ping`
+- Safety: `read-only`
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-profile.md

@@ -0,0 +1,27 @@
+# api profile
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api profile get-rate-limit-status`
+
+Return the caller's current rate-limit and concurrency-limit state without consuming any tokens.
+
+- Request: `GET /v1/profiles/me/limits`
+- Operation ID: `get_rate_limit_status`
+- Safety: `read-only`
+
+### `asknews api profile get-user-profile`
+
+Get the current profile
+
+- Request: `GET /v1/profiles/me`
+- Operation ID: `get_user_profile`
+- Safety: `read-only`
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-reddit.md

@@ -0,0 +1,34 @@
+# api reddit
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api reddit search-reddit`
+
+Go to Reddit, search threads, summarize the threads, return analysis.
+`deep`=True is a live web scrape, AskNews searches Reddit, finds threads,
+summarizes them, analyzes them, and returns the results. `deep`=False
+is a search in AskNews' existing database of Reddit threads.
+
+- Request: `GET /v1/reddit/search`
+- Operation ID: `search_reddit`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--keywords` | Keywords used to search for relevant Reddit threads. Location: query. Type: array<string>. Required. |
+| `--n-threads` | Number of Reddit threads to summarize and return Location: query. Type: integer. Optional. Default: `5`. |
+| `--method` | The search method. Can be 'nl' or 'kw'. If 'nl', then the query will be used as a natural language query. If 'kw', then the query will be used as a direct keyword query. Location: query. Type: string. Optional. Choices: nl, kw. Default: `"kw"`. |
+| `--deep` | Deep means that AskNews goes directly to Reddit, searches live, summarizes the threads live, and returns structured data for you. Deep=False means that AskNews looks in its existing database of Reddit threads and returns the most similar threads Location: query. Type: boolean. Optional. Default: `false`. |
+| `--return-type` | The return type. Can be 'dicts', 'string', or 'both'. Location: query. Type: string. Optional. Choices: dicts, string, both. Default: `"string"`. |
+| `--time-filter` | The time filter. Location: query. Type: string. Optional. Choices: hour, day, week, month, year, all. Default: `"day"`. |
+| `--sort` | The sort order. Location: query. Type: string. Optional. Choices: relevance, hot, top, new, comments. Default: `"relevance"`. |
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-stories.md

@@ -0,0 +1,75 @@
+# api stories
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api stories get-stories`
+
+Filter on our custom, in-house written, stories/events/narratives.
+
+These stories are based on clusters of articles (which come through this
+endpoint as well, so you can consider this a clustering endpoint). We write
+stories and track them through time.
+
+The enrichments include a full Reddit overview (including all the thread metadata),
+as well as descriptions of the reporting voice, the key takeaways, contradictions,
+all the entities, and much, much more.
+
+You can see this data in action, and filter it similarly at
+`https://asknews.app/stories`
+
+- Request: `GET /v1/stories`
+- Operation ID: `get_stories`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--query` | Query to be used for the search. If method='nl', then this will beused as a natural language query. If method='kw', then this willbe used as a direct keyword query. Location: query. Type: string. Optional. |
+| `--categories` | Categories to use for filtering the stories search Location: query. Type: array<string>. Optional. Default: `[]`. |
+| `--uuids` | A list of UUIDs to retrieve. Location: query. Type: array<string>. Optional. Default: `[]`. |
+| `--start-timestamp` | Start timestamp to filter results on. Location: query. Type: string. Optional. |
+| `--end-timestamp` | End timestamp to filter results on. Location: query. Type: string. Optional. |
+| `--sort-by` | Which type of sorting to perform. published: Sort by published date. coverage: Sort by coverage. sentiment: Sort by sentiment. relevance: Sort by relevance of similarity score/ranking. Location: query. Type: string. Optional. |
+| `--sort-type` | Whether to sort results in ascending or descending order. Location: query. Type: string. Optional. |
+| `--continent` | Continents to filter by. Location: query. Type: string. Optional. |
+| `--offset` | Offset to use Location: query. Type: string. Optional. Default: `0`. |
+| `--limit` | Limit to use Location: query. Type: integer. Optional. Default: `10`. |
+| `--expand-updates` | Whether to expand updates Location: query. Type: boolean. Optional. Default: `false`. |
+| `--max-updates` | Max updates to use Location: query. Type: integer. Optional. Default: `2`. |
+| `--max-articles` | Max articles to use per update Location: query. Type: integer. Optional. Default: `5`. |
+| `--method` | Method to use for query, 'nl' means natural language, and will run a semantic search on the stories database. 'kw' means keyword, and will search by keyword on the stories database. 'both' means that both methods will be used and results will be ranked according to IRR. Location: query. Type: string. Optional. Choices: nl, kw, both. Default: `"kw"`. |
+| `--obj-type` | Object type to filter by, can be a list with 'story' and/or 'story_update' Location: query. Type: array<string>. Optional. Default: `["story"]`. |
+| `--reddit` | Whether or not to include Reddit analysiswhere the integer indicates the number of threadsto include in the response. 0 is default. Requirespaid plan to access. Location: query. Type: integer. Optional. Default: `0`. |
+| `--citation-method` | Method to use for citation filtering. Location: query. Type: string. Optional. Choices: brackets, urls, none. Default: `"brackets"`. |
+| `--similarity-score-threshold` | Similarity score threshold to use when using query Location: query. Type: number. Optional. Default: `0.75`. |
+| `--provocative` | Filter stories based on how provocative the underlying articles are deemed based on the use of provocative language and emotional vocabulary. Location: query. Type: string. Optional. Choices: unknown, low, medium, high, all. Default: `"all"`. |
+| `--strategy` | Strategy to use for automatically controlling the search. 'default' is the default strategy, which follows all filters faithfully. 'topstories' aims to give a diverse look at top news stories that are relevant to the current filter combination.'topstories_categories' aims to give the top stories for each category. 'topstories_continents' aims to give the top stories for each continent. Location: query. Type: string. Optional. Choices: default, topstories, topstories_categories, topstories_continents. Default: `"default"`. |
+
+### `asknews api stories get-story`
+
+Get a single news story given its UUID.
+
+- Request: `GET /v1/stories/{story_id}`
+- Operation ID: `get_story`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--story-id` | The story UUID, update UUID, or URL safe title Location: path. Type: string. Required. |
+| `--expand-updates` | Whether to expand updates Location: query. Type: boolean. Optional. Default: `true`. |
+| `--max-updates` | Max number of updates to include in the story object Location: query. Type: integer. Optional. Default: `10`. |
+| `--max-articles` | Max articles to include per update Location: query. Type: integer. Optional. Default: `25`. |
+| `--reddit` | Whether to include Reddit analysis Location: query. Type: integer. Optional. Default: `0`. |
+| `--citation-method` | Method to use for citation filtering. Location: query. Type: string. Optional. Choices: brackets, urls, none. Default: `"brackets"`. |
+| `--condense-auxillary-updates` | When requesting a particular story update, you can expand the assocaited updates by settined max_updates to the total you would like to get. If you want those updates to by condensed for reduced latency, you can set condense_auxillary_updates to 'False'. Location: query. Type: boolean. Optional. Default: `true`. |
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-websearch.md

@@ -0,0 +1,37 @@
+# api websearch
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api websearch live-web-search`
+
+Run a live websearch on a set of queries, get back a fully structured and
+LLM-distilled response (in addition to the raw text if you need that as well).
+
+Your response includes as_string and as_dicts, where as_string is a prompt-optimized
+distillation of the information, done by an LLM. as_dicts contains all the details
+necessary to feed into other parts of your application.
+
+- Request: `GET /v1/chat/websearch`
+- Operation ID: `live_web_search`
+- Safety: `high-cost`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--queries` | A list of queries to be live searched, analyzed, distilled, and structured. Location: query. Type: array<string>. Required. |
+| `--lookback` | Number of hours back to allow the websearch to look. Defaults to All time Location: query. Type: string. Optional. |
+| `--start-datetime` | Earliest acceptable publication datetime for results. For v1, acts like the existing lookback filter. Location: query. Type: string. Optional. |
+| `--end-datetime` | Latest acceptable publication datetime for results. Location: query. Type: string. Optional. |
+| `--engine` | Search engine version to use for live websearch results. Location: query. Type: string. Optional. Choices: v1, v1.5. Default: `"v1"`. |
+| `--domains` | A list of domains to search. Location: query. Type: string. Optional. |
+| `--strict` | If true, the websearch will only return results that have a known publication date and are within the lookback period. Location: query. Type: boolean. Optional. Default: `false`. |
+| `--offset` | The number of results to offset for followup queries. Location: query. Type: string. Optional. Default: `0`. |
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-wiki.md

@@ -0,0 +1,33 @@
+# api wiki
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api wiki search-wiki`
+
+Search on Wikipedia content with natural language. Find exactly relevant chunks,
+with contextual neighbor chunks, and the full articles they came from.
+
+- Request: `GET /v1/wiki/search`
+- Operation ID: `search_wiki`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--query` | Natural language query that can be any phrase, keyword, question, or paragraph. Location: query. Type: string. Optional. Default: `""`. |
+| `--neighbor-chunks` | Number of neighbor chunks to attach and return. If 0, then no neighbor chunks will be returned. Location: query. Type: string. Optional. Default: `1`. |
+| `--n-documents` | Number of documents to return. If 0, then no documents will be returned. Location: query. Type: string. Optional. Default: `5`. |
+| `--full-articles` | If true, then full articles will be returned. If false, then only chunks and their neighbors will be returned. Beware that returning full articles increases data size which increases token usage downstream. Location: query. Type: string. Optional. Default: `false`. |
+| `--hybrid-search` | If true, then hybrid search will be used. If false, then only vector search will be used. Location: query. Type: string. Optional. Default: `false`. |
+| `--string-guarantee` | List of strings that must be present in the results. If empty, then no string guarantee will be applied. Location: query. Type: string. Optional. |
+| `--diversify` | Diversity factor for MMR re-ranking. 0.0 means no diversity (pure relevance), 1.0 means full diversity. Location: query. Type: string. Optional. Default: `0`. |
+| `--include-main-section` | If true, then the main section of the article will be included at the start of each chunk's content. If false, then only the chunk content will be returned. Useful because the main section often contains important context. Location: query. Type: string. Optional. Default: `false`. |
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api.md

@@ -0,0 +1,52 @@
+# api
+
+Discover and invoke generated commands for every customer-facing AskNews API operation.
+
+## Usage
+
+### `asknews api list`
+
+List generated operations and their parameters
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--tag <tag>` | filter by API group |
+| `--safety <level>` | filter by read-only, high-cost, or mutating |
+
+**Examples:**
+
+```bash
+asknews api list --output json
+asknews api list --tag news --safety read-only --output json
+```
+
+## API groups
+
+- [`asknews api alerts`](api-alerts) — 8 operations
+- [`asknews api analytics`](api-analytics) — 1 operations
+- [`asknews api autofilter`](api-autofilter) — 1 operations
+- [`asknews api byok`](api-byok) — 3 operations
+- [`asknews api charts`](api-charts) — 1 operations
+- [`asknews api chat`](api-chat) — 3 operations
+- [`asknews api distribution`](api-distribution) — 2 operations
+- [`asknews api forecast`](api-forecast) — 1 operations
+- [`asknews api graph`](api-graph) — 1 operations
+- [`asknews api index-urls`](api-index-urls) — 1 operations
+- [`asknews api news`](api-news) — 5 operations
+- [`asknews api newsletters`](api-newsletters) — 11 operations
+- [`asknews api ping`](api-ping) — 1 operations
+- [`asknews api profile`](api-profile) — 2 operations
+- [`asknews api reddit`](api-reddit) — 1 operations
+- [`asknews api stories`](api-stories) — 2 operations
+- [`asknews api websearch`](api-websearch) — 1 operations
+- [`asknews api wiki`](api-wiki) — 1 operations
+
+Use `asknews api <group> <operation> --help` for the installed schema and exact enums.
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/auth.md

@@ -0,0 +1,50 @@
+# auth
+
+Authenticate the AskNews CLI
+
+## Commands
+
+### `asknews auth login`
+
+Log in with OAuth device flow or an API key
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--api-key [key]` | store an API key instead of using OAuth |
+| `--no-browser` | do not open the verification URL |
+| `--scope <scope...>` | OAuth scopes Default: `["openid","offline_access","news","chat","stories","analytics","distribution","profile","reddit"]`. |
+
+**Examples:**
+
+```bash
+asknews auth login
+asknews auth login --no-browser
+```
+
+### `asknews auth status`
+
+Show the active authentication method and verify it against AskNews
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--offline` | inspect local state without an API request |
+
+**Examples:**
+
+```bash
+asknews auth status --output json
+```
+
+### `asknews auth logout`
+
+Remove locally stored AskNews credentials
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/cli.md

@@ -0,0 +1,31 @@
+# cli
+
+Manage the AskNews CLI installation
+
+## Commands
+
+### `asknews cli setup`
+
+Install embedded AskNews skills into detected agent directories
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--scope <scope>` | global, project, or all Default: `"global"`. |
+| `--directory <path>` | project directory Default: `"/home/runner/work/asknews-cli/asknews-cli"`. |
+| `--no-agent-skills` | skip agent skill installation |
+| `--quiet` | suppress human setup messages |
+
+**Examples:**
+
+```bash
+asknews cli setup --scope global
+asknews cli setup --scope project --directory .
+```
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/index.md

@@ -0,0 +1,41 @@
+# CLI command reference
+
+Generated from AskNews CLI 0.1.0 and AskNews API 0.24.95.
+
+The installed CLI is authoritative. Run `asknews <command> --help` for the exact options in
+your version. Regenerate these pages with `pnpm sync:openapi`.
+
+| Command | Description |
+| --- | --- |
+| [`auth`](commands/auth) | Authenticate the AskNews CLI |
+| [`news`](commands/news) | Search and inspect AskNews articles |
+| [`stories`](commands/stories) | Search and inspect news stories |
+| [`research`](commands/research) | Run DeepNews research |
+| [`web`](commands/web) | Search the live web |
+| [`reddit`](commands/reddit) | Search Reddit threads |
+| [`wiki`](commands/wiki) | Search Wikipedia |
+| [`alerts`](commands/alerts) | Create and manage AskNews alerts |
+| [`request`](commands/request) | Make an authenticated request to an API path |
+| [`cli`](commands/cli) | Manage the AskNews CLI installation |
+| [`api`](commands/api) | Discover and invoke every customer-facing AskNews API operation |
+
+## Generated API groups
+
+- [`alerts`](commands/api-alerts) — Generated alerts API operations
+- [`analytics`](commands/api-analytics) — Generated analytics API operations
+- [`autofilter`](commands/api-autofilter) — Generated autofilter API operations
+- [`byok`](commands/api-byok) — Generated byok API operations
+- [`charts`](commands/api-charts) — Generated charts API operations
+- [`chat`](commands/api-chat) — Generated chat API operations
+- [`distribution`](commands/api-distribution) — Generated distribution API operations
+- [`forecast`](commands/api-forecast) — Generated forecast API operations
+- [`graph`](commands/api-graph) — Generated graph API operations
+- [`index-urls`](commands/api-index-urls) — Generated index-urls API operations
+- [`news`](commands/api-news) — Generated news API operations
+- [`newsletters`](commands/api-newsletters) — Generated newsletters API operations
+- [`ping`](commands/api-ping) — Generated ping API operations
+- [`profile`](commands/api-profile) — Generated profile API operations
+- [`reddit`](commands/api-reddit) — Generated reddit API operations
+- [`stories`](commands/api-stories) — Generated stories API operations
+- [`websearch`](commands/api-websearch) — Generated websearch API operations
+- [`wiki`](commands/api-wiki) — Generated wiki API operations