@atypica-ai/cli 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,231 @@
+![head-image](./head-image.webp)
+
+# Atypica CLI
+
+**Use the terminal to see what the world is talking about.**
+
+[atypica.ai](https://atypica.ai) is an AI agent for business research.  
+This CLI is the official command-line client for the **Pulse** API, and Pulse is only the first step in the broader atypica product roadmap.  
+Pulse tracks how attention moves across the web so you can spot signals worth following before they fade.
+
+**Who it’s for**
+
+- **Creators** — find timely topics with real momentum  
+- **Researchers** — follow domains like AI, global news, or business  
+- **Developers & agents** — pipe trend data into scripts and automation  
+
+Simplified Chinese: [README.zh-CN.md](./README.zh-CN.md)
+
+---
+
+## Install
+
+```bash
+npm install -g @atypica-ai/cli
+```
+
+Or with pnpm:
+
+```bash
+pnpm add -g @atypica-ai/cli
+```
+
+Requires **Node.js 20+**.
+
+---
+
+## 30-second quick start
+
+```bash
+atypica auth login                              # sign in and save your API key
+atypica pulse list --limit 5 --locale zh-CN     # latest Chinese trending items
+atypica pulse get 3396                          # one pulse by ID (replace with a real ID)
+```
+
+Check auth without logging in again:
+
+```bash
+atypica auth status
+```
+
+If you already have a key and prefer not to use saved config:
+
+```bash
+export ATYPICA_API_KEY="atypica_xxx"
+atypica pulse list --limit 5
+```
+
+---
+
+## What this CLI does (v1)
+
+- Reads Pulse data from `https://atypica.ai/api` (override with `ATYPICA_BASE_URL`)
+- Walks you through creating a **Personal API Key** and stores it locally
+- **Human-readable** tables by default, plus stable **`--json`** for scripts
+- Optional **version check** and **`atypica self-update`**
+
+---
+
+## Commands
+
+List pulses:
+
+```bash
+atypica pulse list --limit 5 --locale en-US
+```
+
+Faster list (skip extra source lookups):
+
+```bash
+atypica pulse list --limit 20 --page 2 --no-source-enrich
+```
+
+Filter by category and sort:
+
+```bash
+atypica pulse list --category "AI Tech" --order-by heatScore
+```
+
+List categories:
+
+```bash
+atypica pulse categories --locale en-US
+```
+
+Fetch one pulse:
+
+```bash
+atypica pulse get 193
+```
+
+Machine-readable output:
+
+```bash
+atypica pulse list --limit 3 --json
+```
+
+Help:
+
+```bash
+atypica help
+atypica auth help
+atypica pulse help
+```
+
+---
+
+## Agent & automation
+
+The CLI is meant to be called from other tools and agents.
+
+- Use **`--json`** whenever something else will parse the output  
+- Use **`--no-update-check`** in CI to avoid extra stderr noise  
+- Prefer **environment variables** over interactive login in automation:
+
+```bash
+ATYPICA_API_KEY="atypica_xxx" \
+ATYPICA_BASE_URL="https://atypica.ai/api" \
+atypica pulse list --limit 10 --json --no-update-check
+```
+
+- Set explicit **`--limit`**, **`--locale`**, and **`--order-by`** when you need repeatable results  
+- **Non-zero exit code** means failure (including missing or invalid auth)
+
+---
+
+## Updates
+
+The CLI runs a **non-blocking** update check during normal use.
+
+Manual upgrade:
+
+```bash
+atypica self-update
+atypica self-update --yes
+```
+
+Skip the check for one run:
+
+```bash
+atypica pulse list --no-update-check
+```
+
+---
+
+## Configuration
+
+Default config file:
+
+- macOS / Linux: `~/.config/atypica/config.json`  
+- If `XDG_CONFIG_HOME` is set: `$XDG_CONFIG_HOME/atypica/config.json`
+
+Environment variables (override saved config at runtime):
+
+| Variable | Purpose |
+|----------|---------|
+| `ATYPICA_API_KEY` | Personal API key |
+| `ATYPICA_BASE_URL` | API base (default below) |
+| `ATYPICA_UPDATE_CHECK=0` | Disable update check |
+
+Default base URL:
+
+```text
+https://atypica.ai/api
+```
+
+---
+
+## Example output
+
+```bash
+$ atypica pulse list --limit 3 --locale en-US
+ID    Category     Locale  Date        Heat    Delta   Source                          Title                              Summary
+----  -----------  ------  ----------  ------  ------  ------------------------------  ---------------------------------  ---------------------------------
+2918  Global News  en-US   2026-04-12  453.20  +7.40   https://x.com/.../status/123   US Pilot Rescue Uranium Claim      Rescue claim triggers new debate…
+2940  AI Business  en-US   2026-04-12  262.90  -       https://twitter.com/.../456    OpenAI Codex plugin for Claude     New plugin connects Claude tools…
+3396  AI Tech      en-US   2026-04-12  323.67  +4.08   -                               bitnet.cpp: Microsoft 1-bit AI…    1-bit inference benchmark update…
+
+Page 1/28  ·  Total 278  ·  PageSize 3  ·  Prev no  ·  Next yes
+Tip: atypica pulse list --page 2 --limit 3
+```
+
+```bash
+$ atypica pulse get 3396 --json
+{
+  "id": 3396,
+  "title": "bitnet.cpp: Microsoft 1-bit AI inference",
+  "content": "...",
+  "category": "AI Tech",
+  "locale": "en-US",
+  "heatScore": 323.6711869385739,
+  "heatDelta": null,
+  "createdAt": "2026-04-10T14:00:39.241Z",
+  "posts": []
+}
+```
+
+---
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+node dist/cli.js help
+```
+
+(You can use `pnpm install` / `pnpm run build` / `pnpm test` if you prefer.)
+
+---
+
+## Documentation
+
+- Pulse: `https://atypica.ai/docs/pulse`  
+- Developer hub: `https://atypica.ai/docs`
+
+---
+
+## Agent skill
+
+This repo includes [`SKILL.md`](./SKILL.md) for agents that need to call atypica APIs—point your agent tooling at that file for prompts and conventions.

package/README.zh-CN.md

@@ -0,0 +1,227 @@
+![head-image](./head-image.webp)
+
+# Atypica CLI
+
+> 用命令行捕捉「世界正在讨论什么」。
+
+[atypica.ai](https://atypica.ai) 是一个做商业研究的 AI 智能体。  
+`atypica` CLI 是其 **Pulse API** 的官方命令行客户端，而 **Pulse** 只是整个产品能力的第一步。  
+Pulse 会持续追踪全网内容的热度变化，帮你更快看到值得跟进的趋势信号。
+
+**适合谁用**
+
+- **内容创作者** — 找当下有热度、值得写的选题  
+- **研究者** — 跟踪特定领域（如 AI、全球新闻、商业）的动向  
+- **开发者 / Agent** — 把热点数据接进脚本与自动化流程  
+
+英文主文档：[README.md](./README.md)
+
+---
+
+## 安装
+
+```bash
+npm install -g @atypica-ai/cli
+```
+
+或使用 pnpm：
+
+```bash
+pnpm add -g @atypica-ai/cli
+```
+
+需要 **Node.js 20+**。
+
+---
+
+## 30 秒上手
+
+```bash
+atypica auth login                          # 登录，保存 API Key
+atypica pulse list --limit 5 --locale zh-CN  # 查看最新中文热点
+atypica pulse get 3396                      # 查看某条热点详情（请换成真实 ID）
+```
+
+查看当前登录状态：
+
+```bash
+atypica auth status
+```
+
+若已有 Key、不想写入本机配置文件，可用环境变量：
+
+```bash
+export ATYPICA_API_KEY="atypica_xxx"
+atypica pulse list --limit 5
+```
+
+---
+
+## CLI 能做什么（v1）
+
+- 从 `https://atypica.ai/api` 读取 Pulse 数据（可用 `ATYPICA_BASE_URL` 覆盖）  
+- 引导你创建 **Personal API Key** 并保存在本机  
+- 默认输出**人类可读表格**，脚本场景使用稳定的 **`--json`**  
+- 可选**版本检查**与 **`atypica self-update` 自更新**
+
+---
+
+## 常用命令
+
+列出热点：
+
+```bash
+atypica pulse list --limit 5 --locale en-US
+```
+
+更快列出（关闭来源补充查询）：
+
+```bash
+atypica pulse list --limit 20 --page 2 --no-source-enrich
+```
+
+按分类筛选、排序：
+
+```bash
+atypica pulse list --category "AI Tech" --order-by heatScore
+```
+
+列出分类：
+
+```bash
+atypica pulse categories --locale en-US
+```
+
+查看单条：
+
+```bash
+atypica pulse get 193
+```
+
+给脚本用（JSON）：
+
+```bash
+atypica pulse list --limit 3 --json
+```
+
+帮助：
+
+```bash
+atypica help
+atypica auth help
+atypica pulse help
+```
+
+---
+
+## Agent 与自动化
+
+- 需要被程序解析时，请加 **`--json`**  
+- CI 里建议加 **`--no-update-check`**，减少 stderr 干扰  
+- 自动化场景优先用**环境变量**，不要交互式登录：
+
+```bash
+ATYPICA_API_KEY="atypica_xxx" \
+ATYPICA_BASE_URL="https://atypica.ai/api" \
+atypica pulse list --limit 10 --json --no-update-check
+```
+
+- 需要结果可复现时，请显式指定 **`--limit`**、**`--locale`**、**`--order-by`** 等  
+- **非 0 退出码** 表示失败（含未配置或无效 Key）
+
+---
+
+## 更新
+
+日常使用时会**非阻塞**检查新版本。手动升级：
+
+```bash
+atypica self-update
+atypica self-update --yes
+```
+
+单次运行跳过检查：
+
+```bash
+atypica pulse list --no-update-check
+```
+
+---
+
+## 配置
+
+默认配置文件路径：
+
+- macOS / Linux：`~/.config/atypica/config.json`  
+- 若设置了 `XDG_CONFIG_HOME`：`$XDG_CONFIG_HOME/atypica/config.json`
+
+环境变量（运行时覆盖本地配置）：
+
+| 变量 | 作用 |
+|------|------|
+| `ATYPICA_API_KEY` | 个人 API Key |
+| `ATYPICA_BASE_URL` | API 根地址（默认见下） |
+| `ATYPICA_UPDATE_CHECK=0` | 关闭更新检查 |
+
+默认 API 根地址：
+
+```text
+https://atypica.ai/api
+```
+
+---
+
+## 示例输出
+
+```bash
+$ atypica pulse list --limit 3 --locale en-US
+ID    Category     Locale  Date        Heat    Delta   Source                          Title                              Summary
+----  -----------  ------  ----------  ------  ------  ------------------------------  ---------------------------------  ---------------------------------
+2918  Global News  en-US   2026-04-12  453.20  +7.40   https://x.com/.../status/123   US Pilot Rescue Uranium Claim      Rescue claim triggers new debate…
+2940  AI Business  en-US   2026-04-12  262.90  -       https://twitter.com/.../456    OpenAI Codex plugin for Claude     New plugin connects Claude tools…
+3396  AI Tech      en-US   2026-04-12  323.67  +4.08   -                               bitnet.cpp: Microsoft 1-bit AI…    1-bit inference benchmark update…
+
+Page 1/28  ·  Total 278  ·  PageSize 3  ·  Prev no  ·  Next yes
+Tip: atypica pulse list --page 2 --limit 3
+```
+
+```bash
+$ atypica pulse get 3396 --json
+{
+  "id": 3396,
+  "title": "bitnet.cpp: Microsoft 1-bit AI inference",
+  "content": "...",
+  "category": "AI Tech",
+  "locale": "en-US",
+  "heatScore": 323.6711869385739,
+  "heatDelta": null,
+  "createdAt": "2026-04-10T14:00:39.241Z",
+  "posts": []
+}
+```
+
+---
+
+## 本地开发
+
+```bash
+npm install
+npm run build
+npm test
+node dist/cli.js help
+```
+
+（也可使用 `pnpm install` / `pnpm run build` / `pnpm test`。）
+
+---
+
+## 文档链接
+
+- Pulse：`https://atypica.ai/docs/pulse`  
+- 开发者文档：`https://atypica.ai/docs`
+
+---
+
+## Agent 技能说明
+
+仓库中的 [`SKILL.md`](./SKILL.md) 供 Agent 引用：若你在做会调用 atypica API 的智能体，可直接让工具读取该文件。

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { printAuthHelp, runAuthCommand } from "./commands/auth.js";
+import { printPulseHelp, runPulseCommand } from "./commands/pulse.js";
+import { runSelfUpdateCommand } from "./commands/self-update.js";
+import { resolveConfig } from "./lib/config.js";
+import { CliError } from "./lib/errors.js";
+import { maybeNotifyForUpdates } from "./lib/update.js";
+import { printError, printInfo } from "./lib/output.js";
+async function readVersion() {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(currentDir, "..", "package.json");
+    const content = await readFile(pkgPath, "utf8");
+    return JSON.parse(content).version;
+}
+function extractGlobalFlags(argv) {
+    const args = [];
+    let json = false;
+    let updateCheck = true;
+    for (const arg of argv) {
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        if (arg === "--no-update-check") {
+            updateCheck = false;
+            continue;
+        }
+        args.push(arg);
+    }
+    return {
+        context: { json, updateCheck },
+        args,
+    };
+}
+function printHelp() {
+    printInfo("atypica CLI");
+    printInfo("");
+    printInfo("Usage:");
+    printInfo("  atypica <command> <subcommand> [options]");
+    printInfo("");
+    printInfo("Core commands:");
+    printInfo("  auth         Configure and inspect Personal API Key access");
+    printInfo("  pulse        Query Pulse categories, lists, and details");
+    printInfo("  self-update  Print or run the recommended upgrade command");
+    printInfo("  help         Show global or command-specific help");
+    printInfo("");
+    printInfo("Global flags:");
+    printInfo("  --json             Output machine-readable JSON when supported");
+    printInfo("  --no-update-check  Disable the background version check for this run");
+    printInfo("");
+    printInfo("Examples:");
+    printInfo("  atypica auth login");
+    printInfo("  atypica pulse list --limit 5 --locale en-US");
+    printInfo("  atypica pulse get 3396 --json --no-update-check");
+    printInfo("");
+    printInfo("Agent tips:");
+    printInfo("  - Use `--json` for downstream parsing");
+    printInfo("  - Prefer env-based auth in automation: `ATYPICA_API_KEY=... atypica pulse list --json`");
+    printInfo("  - Run `atypica pulse help` or `atypica auth help` for detailed command help");
+}
+async function main() {
+    const version = await readVersion();
+    const { context, args } = extractGlobalFlags(process.argv.slice(2));
+    const [command, ...rest] = args;
+    if (!command || command === "help" || command === "--help" || command === "-h") {
+        const [maybeSubcommand] = rest;
+        if (maybeSubcommand === "auth") {
+            printAuthHelp();
+            return;
+        }
+        if (maybeSubcommand === "pulse") {
+            printPulseHelp();
+            return;
+        }
+        printHelp();
+        return;
+    }
+    if (command === "--version" || command === "-v" || command === "version") {
+        printInfo(version);
+        return;
+    }
+    const config = resolveConfig();
+    if (context.updateCheck && config.updateCheck !== false) {
+        void maybeNotifyForUpdates(version, config);
+    }
+    if (command === "auth") {
+        await runAuthCommand(rest, context);
+        return;
+    }
+    if (command === "pulse") {
+        await runPulseCommand(rest, context);
+        return;
+    }
+    if (command === "self-update") {
+        await runSelfUpdateCommand(rest, context);
+        return;
+    }
+    throw new CliError(`Unknown command: ${command}`);
+}
+main().catch((error) => {
+    const { context } = extractGlobalFlags(process.argv.slice(2));
+    printError(error, context);
+    process.exit(error instanceof CliError ? error.code : 1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/auth.d.ts

@@ -0,0 +1,3 @@
+import { CliContext } from "../types.js";
+export declare function printAuthHelp(): void;
+export declare function runAuthCommand(args: string[], context: CliContext): Promise<void>;

package/dist/commands/auth.js

@@ -0,0 +1,76 @@
+import { API_KEY_URL, DOCS_URL } from "../lib/constants.js";
+import { loadConfig, resolveConfig, saveConfig } from "../lib/config.js";
+import { promptForApiKey } from "../lib/auth.js";
+import { printInfo, printJson } from "../lib/output.js";
+export function printAuthHelp() {
+    printInfo("Usage:");
+    printInfo("  atypica auth login");
+    printInfo("  atypica auth status");
+    printInfo("  atypica auth logout");
+    printInfo("");
+    printInfo("Commands:");
+    printInfo("  login   Start interactive API key setup and validate the key");
+    printInfo("  status  Show whether auth is configured and where it comes from");
+    printInfo("  logout  Remove the saved local API key");
+    printInfo("");
+    printInfo("Notes:");
+    printInfo("  - `ATYPICA_API_KEY` overrides the saved local config");
+    printInfo(`  - Generate keys at ${API_KEY_URL}`);
+    printInfo(`  - API docs: ${DOCS_URL}`);
+}
+export async function runAuthCommand(args, context) {
+    const [subcommand] = args;
+    if (!subcommand || subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
+        printAuthHelp();
+        return;
+    }
+    if (subcommand === "login") {
+        const config = resolveConfig();
+        const apiKey = await promptForApiKey(config);
+        saveConfig({
+            ...loadConfig(),
+            apiKey,
+        });
+        if (context.json) {
+            printJson({ success: true, configured: true });
+            return;
+        }
+        printInfo("API key saved.");
+        printInfo(`Manage keys: ${API_KEY_URL}`);
+        return;
+    }
+    if (subcommand === "status") {
+        const config = resolveConfig();
+        const configured = Boolean(config.apiKey);
+        const payload = {
+            configured,
+            source: process.env.ATYPICA_API_KEY ? "env" : configured ? "config" : "none",
+            baseUrl: config.baseUrl,
+            docsUrl: DOCS_URL,
+            apiKeyUrl: API_KEY_URL,
+        };
+        if (context.json) {
+            printJson(payload);
+            return;
+        }
+        printInfo(`Configured: ${configured ? "yes" : "no"}`);
+        printInfo(`Source: ${payload.source}`);
+        printInfo(`Base URL: ${payload.baseUrl}`);
+        return;
+    }
+    if (subcommand === "logout") {
+        const fileConfig = loadConfig();
+        saveConfig({
+            ...fileConfig,
+            apiKey: undefined,
+        });
+        if (context.json) {
+            printJson({ success: true, configured: false });
+            return;
+        }
+        printInfo("Saved API key removed from local config.");
+        return;
+    }
+    printAuthHelp();
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"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"}

package/dist/commands/pulse.d.ts

@@ -0,0 +1,3 @@
+import { CliContext } from "../types.js";
+export declare function printPulseHelp(): void;
+export declare function runPulseCommand(args: string[], context: CliContext): Promise<void>;