@aisa-one/cli 0.1.3 → 0.1.5

package/README.md

@@ -60,16 +60,15 @@ aisa models show gpt-4.1             # model details + pricing
 ### API Discovery & Execution
 
 ```bash
-aisa api list                                # list all API endpoints
-aisa api list --category finance             # filter by category
-aisa api search "email finder"               # natural language search
-aisa api show finance /stock/price           # endpoint details + params
-aisa api code finance /stock/price --lang python  # generate code snippet
-
-# Execute any API
-aisa run finance /stock/price -q "symbol=AAPL"
+aisa api list                                # 🚧 WIP — not yet available
+aisa api search "email finder"               # 🚧 WIP
+aisa api show finance /stock/price           # 🚧 WIP
+aisa api code finance /stock/price --lang python  # 🚧 WIP
+
+# Execute any API (works now)
+aisa run financial /insider-trades -q "ticker=AAPL"
 aisa run tavily /search -d '{"query": "AI news"}'
-aisa run twitter /tweet/advanced-search -q "query=AI agents" --raw
+aisa run twitter /tweet/advanced_search -q "query=AI agents" --raw
 ```
 
 ### Web Search
@@ -85,11 +84,12 @@ aisa scholar "transformer architecture"     # academic papers
 ### Finance
 
 ```bash
-aisa stock AAPL                     # stock price
-aisa stock MSFT --field earnings    # earnings data
+aisa stock AAPL --field insider     # insider trades
+aisa stock AAPL --field news        # company news
 aisa stock TSLA --field filings     # SEC filings
-aisa stock NVDA --field insider     # insider trades
-aisa crypto BTC                     # crypto price
+aisa stock AAPL --field price       # stock price (⚠️ may return empty for some tickers)
+aisa stock MSFT --field earnings    # earnings data (⚠️ limited ticker support)
+aisa crypto BTC                     # crypto price snapshot
 aisa crypto ETH --period 30d       # historical
 aisa screener --sector Technology   # stock screener
 ```
@@ -97,11 +97,10 @@ aisa screener --sector Technology   # stock screener
 ### Twitter/X
 
 ```bash
-aisa tweet "Hello world!"                   # post a tweet
-aisa tweet "Reply" --reply-to 123456        # reply
-aisa twitter search "AI agents" --limit 20  # search tweets
 aisa twitter user elonmusk                  # user profile
+aisa twitter search "AI agents" --limit 20  # search tweets
 aisa twitter trends                         # trending topics
+aisa tweet "Hello world!"                   # post (⚠️ requires login cookies, see docs)
 ```
 
 ### Video Generation
@@ -115,9 +114,8 @@ aisa video status <task-id>                      # check status
 ### Account
 
 ```bash
-aisa balance                # credit balance
-aisa usage --limit 20       # usage history
-aisa usage --days 7         # last 7 days
+aisa balance                # 🚧 WIP — check https://aisa.one/dashboard
+aisa usage --limit 20       # 🚧 WIP
 ```
 
 ## Skills
@@ -127,12 +125,11 @@ Skills are markdown files that teach AI coding agents (Claude Code, Cursor, Copi
 ### Browse & Install
 
 ```bash
-aisa skills list                              # browse skills
-aisa skills search "financial analysis"       # search
-aisa skills show aisa-team/finance-analyst    # details
-aisa skills add aisa-team/finance-analyst     # install to all agents
-aisa skills add aisa-team/llm-assistant --agent claude  # specific agent
-aisa skills remove aisa-team/finance-analyst  # uninstall
+aisa skills list                              # 🚧 WIP — requires backend
+aisa skills search "financial analysis"       # 🚧 WIP
+aisa skills show aisa-team/finance-analyst    # 🚧 WIP
+aisa skills add aisa-team/finance-analyst     # 🚧 WIP
+aisa skills remove aisa-team/finance-analyst  # 🚧 WIP
 ```
 
 Skills install to agent directories automatically:
@@ -150,12 +147,12 @@ Skills install to agent directories automatically:
 ### Create & Publish
 
 ```bash
-aisa skills init my-skill                          # create from default template
+aisa skills init my-skill                          # create from default template (works locally)
 aisa skills init my-skill --template finance       # finance template
 aisa skills init my-skill --template llm           # LLM template
-aisa skills submit ./my-skill                      # submit to AISA
-aisa skills push owner/my-skill                    # push updates
-aisa skills request-verification owner/my-skill    # request review
+aisa skills submit ./my-skill                      # 🚧 WIP — requires backend
+aisa skills push owner/my-skill                    # 🚧 WIP
+aisa skills request-verification owner/my-skill    # 🚧 WIP
 ```
 
 Available templates: `default`, `llm`, `search`, `finance`, `twitter`, `video`

package/dist/commands/account.d.ts

@@ -1,5 +1,5 @@
 export declare function balanceAction(): Promise<void>;
-export declare function usageAction(options: {
+export declare function usageAction(_options: {
     limit?: string;
     days?: string;
 }): Promise<void>;

package/dist/commands/account.js

@@ -1,47 +1,13 @@
-import ora from "ora";
 import chalk from "chalk";
 import { requireApiKey } from "../config.js";
-import { apiRequest } from "../api.js";
-import { error, table } from "../utils/display.js";
+import { hint } from "../utils/display.js";
 export async function balanceAction() {
-    const key = requireApiKey();
-    const spinner = ora("Fetching balance...").start();
-    const res = await apiRequest(key, "credits/balance");
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to fetch balance");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    console.log(`  Balance: ${chalk.green("$" + res.data.balance.toFixed(2))} ${res.data.currency}`);
-    console.log(chalk.gray("  Add credits at https://aisa.one/dashboard/wallet"));
+    requireApiKey();
+    console.log(chalk.yellow("  Balance API is not yet available."));
+    hint("Check your balance at https://aisa.one/dashboard");
 }
-export async function usageAction(options) {
-    const key = requireApiKey();
-    const spinner = ora("Fetching usage...").start();
-    const query = {};
-    if (options.limit)
-        query.limit = options.limit;
-    if (options.days)
-        query.days = options.days;
-    const res = await apiRequest(key, "credits/usage", { query });
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to fetch usage");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    const { records } = res.data;
-    if (records.length === 0) {
-        console.log("  No usage records found.");
-        return;
-    }
-    const rows = records.map((r) => [
-        new Date(r.timestamp).toLocaleDateString(),
-        r.api,
-        r.endpoint,
-        `$${r.cost.toFixed(4)}`,
-        r.status,
-    ]);
-    console.log(table(["Date", "API", "Endpoint", "Cost", "Status"], rows));
+export async function usageAction(_options) {
+    requireApiKey();
+    console.log(chalk.yellow("  Usage API is not yet available."));
+    hint("View usage history at https://aisa.one/dashboard");
 }

package/dist/commands/api.d.ts

@@ -1,10 +1,10 @@
-export declare function apiListAction(options: {
+export declare function apiListAction(_options: {
     category?: string;
 }): Promise<void>;
-export declare function apiSearchAction(query: string, options: {
+export declare function apiSearchAction(_query: string, _options: {
     limit?: string;
 }): Promise<void>;
-export declare function apiShowAction(slug: string, path?: string): Promise<void>;
-export declare function apiCodeAction(slug: string, path: string, options: {
+export declare function apiShowAction(_slug: string, _path?: string): Promise<void>;
+export declare function apiCodeAction(_slug: string, _path: string, _options: {
     lang?: string;
 }): Promise<void>;

package/dist/commands/api.js

@@ -1,116 +1,26 @@
-import ora from "ora";
 import chalk from "chalk";
 import { requireApiKey } from "../config.js";
-import { apiRequest } from "../api.js";
-import { error, badge, table, hint, truncate } from "../utils/display.js";
-export async function apiListAction(options) {
-    const key = requireApiKey();
-    const spinner = ora("Listing APIs...").start();
-    const query = {};
-    if (options.category)
-        query.category = options.category;
-    const res = await apiRequest(key, "cli/apis", { query });
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to list APIs");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    const { apis } = res.data;
-    if (apis.length === 0) {
-        console.log("  No APIs found.");
-        return;
-    }
-    for (const api of apis) {
-        console.log(`\n  ${chalk.cyan.bold(api.name)} ${chalk.gray(api.slug)} ${badge(api.category)}`);
-        console.log(`  ${chalk.gray(api.description)}`);
-        const shown = api.endpoints.slice(0, 3);
-        for (const ep of shown) {
-            console.log(`    ${chalk.yellow(ep.method.padEnd(6))} ${ep.path} ${chalk.gray("- " + truncate(ep.description, 50))}`);
-        }
-        if (api.endpoints.length > 3) {
-            hint(`+${api.endpoints.length - 3} more endpoints`);
-        }
-    }
-    console.log(chalk.gray("\n  Run 'aisa api show <slug>' for endpoint details"));
+import { hint } from "../utils/display.js";
+const COMING_SOON = chalk.yellow("  API catalog is not yet available.");
+const BROWSE_HINT = "Browse available APIs at https://docs.aisa.one/reference";
+export async function apiListAction(_options) {
+    requireApiKey();
+    console.log(COMING_SOON);
+    hint(BROWSE_HINT);
+    hint("Use 'aisa run <slug> <path>' to call APIs directly");
 }
-export async function apiSearchAction(query, options) {
-    const key = requireApiKey();
-    const spinner = ora(`Searching "${query}"...`).start();
-    const res = await apiRequest(key, "cli/apis/search", {
-        method: "POST",
-        body: { query, limit: parseInt(options.limit || "10") },
-    });
-    if (!res.success || !res.data) {
-        spinner.fail("Search failed");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    const { apis } = res.data;
-    if (apis.length === 0) {
-        console.log(`  No APIs found for "${query}".`);
-        return;
-    }
-    for (const api of apis) {
-        console.log(`\n  ${chalk.cyan.bold(api.name)} ${chalk.gray(api.slug)} ${badge(api.category)}`);
-        console.log(`  ${chalk.gray(api.description)}`);
-        for (const ep of api.endpoints.slice(0, 2)) {
-            console.log(`    ${chalk.yellow(ep.method.padEnd(6))} ${ep.path}`);
-        }
-    }
-    console.log(chalk.gray("\n  Run 'aisa run <slug> <path>' to execute"));
+export async function apiSearchAction(_query, _options) {
+    requireApiKey();
+    console.log(COMING_SOON);
+    hint(BROWSE_HINT);
 }
-export async function apiShowAction(slug, path) {
-    const key = requireApiKey();
-    const spinner = ora(`Loading ${slug}${path ? " " + path : ""}...`).start();
-    const endpoint = path ? `cli/apis/${slug}${path}` : `cli/apis/${slug}`;
-    const res = await apiRequest(key, endpoint);
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to load API details");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    const data = res.data;
-    if ("endpoints" in data) {
-        // ApiGroup
-        console.log(`\n  ${chalk.cyan.bold(data.name)} ${badge(data.category)}`);
-        console.log(`  ${data.description}\n`);
-        for (const ep of data.endpoints) {
-            console.log(`  ${chalk.yellow(ep.method.padEnd(6))} ${ep.path}`);
-            console.log(`  ${chalk.gray(ep.description)}`);
-        }
-    }
-    else {
-        // ApiEndpoint with parameters
-        console.log(`\n  ${chalk.yellow(data.method)} ${data.path}`);
-        console.log(`  ${data.description}\n`);
-        if (data.parameters && data.parameters.length > 0) {
-            const rows = data.parameters.map((p) => [
-                p.name,
-                p.type,
-                p.required ? chalk.red("required") : "optional",
-                truncate(p.description, 40),
-            ]);
-            console.log(table(["Name", "Type", "Required", "Description"], rows));
-        }
-        console.log(chalk.gray(`\n  Example: aisa run ${slug} ${data.path} -q "param=value"`));
-    }
+export async function apiShowAction(_slug, _path) {
+    requireApiKey();
+    console.log(COMING_SOON);
+    hint(BROWSE_HINT);
 }
-export async function apiCodeAction(slug, path, options) {
-    const key = requireApiKey();
-    const lang = options.lang || "typescript";
-    const spinner = ora(`Generating ${lang} code...`).start();
-    const res = await apiRequest(key, "cli/apis/code", {
-        method: "POST",
-        body: { slug, path, language: lang },
-    });
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to generate code");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    console.log(`\n${res.data.code}`);
+export async function apiCodeAction(_slug, _path, _options) {
+    requireApiKey();
+    console.log(COMING_SOON);
+    hint(BROWSE_HINT);
 }

package/dist/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.1.3";
+export declare const VERSION = "0.1.5";
 export declare const BASE_URL = "https://api.aisa.one";
 export declare const CLI_BASE_URL = "https://api.aisa.one/v1";
 export declare const APIS_BASE_URL = "https://api.aisa.one/apis/v1";

package/dist/constants.js

@@ -1,4 +1,4 @@
-export const VERSION = "0.1.3";
+export const VERSION = "0.1.5";
 export const BASE_URL = "https://api.aisa.one";
 export const CLI_BASE_URL = `${BASE_URL}/v1`;
 export const APIS_BASE_URL = `${BASE_URL}/apis/v1`;

package/dist/index.js

@@ -58,33 +58,33 @@ program
 // ── Account ──
 program
     .command("balance")
-    .description("Show credit balance")
+    .description("Show credit balance (WIP)")
     .action(wrap(balanceAction));
 program
     .command("usage")
-    .description("Show usage history")
+    .description("Show usage history (WIP)")
     .option("--limit <n>", "Max records")
     .option("--days <n>", "Lookback days")
     .action(wrap(usageAction));
 // ── API ──
-const api = program.command("api").description("Discover and inspect APIs");
+const api = program.command("api").description("Discover and inspect APIs (WIP)");
 api
     .command("list")
-    .description("List available API endpoints")
+    .description("List available API endpoints (WIP)")
     .option("--category <cat>", "Filter by category (llm, search, finance, twitter, video, scholar)")
     .action(wrap(apiListAction));
 api
     .command("search <query>")
-    .description("Search APIs by keyword")
+    .description("Search APIs by keyword (WIP)")
     .option("--limit <n>", "Max results")
     .action(wrap(apiSearchAction));
 api
     .command("show <slug> [path]")
-    .description("Show API endpoint details")
+    .description("Show API endpoint details (WIP)")
     .action(wrap(apiShowAction));
 api
     .command("code <slug> <path>")
-    .description("Generate code snippet")
+    .description("Generate code snippet (WIP)")
     .option("--lang <language>", "Language: typescript, python, curl", "typescript")
     .action(wrap(apiCodeAction));
 // ── Run ──
@@ -202,32 +202,32 @@ video
 const skills = program.command("skills").description("Browse and manage agent skills");
 skills
     .command("list")
-    .description("List available skills")
+    .description("List available skills (WIP)")
     .option("--category <cat>", "Filter by category")
     .option("--limit <n>", "Max results")
     .action(wrap(skillsListAction));
 skills
     .command("search <query>")
-    .description("Search skills")
+    .description("Search skills (WIP)")
     .option("--limit <n>", "Max results")
     .action(wrap(skillsSearchAction));
 skills
     .command("show <slug>")
-    .description("Show skill details")
+    .description("Show skill details (WIP)")
     .action(wrap(skillsShowAction));
 skills
     .command("add <slug>")
-    .description("Install a skill to agent directories")
+    .description("Install a skill to agent directories (WIP)")
     .option("--agent <agent>", "Target agent: claude, cursor, copilot, windsurf, codex, gemini, openclaw, all")
     .action(wrap(skillsAddAction));
 skills
     .command("remove <slug>")
-    .description("Remove an installed skill")
+    .description("Remove an installed skill (WIP)")
     .option("--agent <agent>", "Target agent")
     .action(skillsRemoveAction);
 skills
     .command("update [slug]")
-    .description("Update installed skill(s)")
+    .description("Update installed skill(s) (WIP)")
     .action(wrap(skillsUpdateAction));
 skills
     .command("init <name>")
@@ -237,15 +237,15 @@ skills
     .action(skillsInitAction);
 skills
     .command("submit <path>")
-    .description("Submit a skill to AISA")
+    .description("Submit a skill to AISA (WIP)")
     .action(wrap(skillsSubmitAction));
 skills
     .command("push <slug>")
-    .description("Push local changes to a submitted skill")
+    .description("Push local changes to a submitted skill (WIP)")
     .action(wrap(skillsPushAction));
 skills
     .command("request-verification <slug>")
-    .description("Request skill verification")
+    .description("Request skill verification (WIP)")
     .action(wrap(skillsVerifyAction));
 // ── MCP ──
 const mcp = program.command("mcp").description("MCP server integration");
@@ -279,12 +279,12 @@ configCmd
 // ── Top-level aliases ──
 program
     .command("search <query>")
-    .description("Search APIs (alias for 'api search')")
+    .description("Search APIs (alias for 'api search') (WIP)")
     .option("--limit <n>", "Max results")
     .action(wrap(apiSearchAction));
 program
     .command("code <slug> <path>")
-    .description("Generate code (alias for 'api code')")
+    .description("Generate code (alias for 'api code') (WIP)")
     .option("--lang <language>", "Language", "typescript")
     .action(wrap(apiCodeAction));
 // ── Parse ──

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aisa-one/cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "CLI for the AISA unified AI infrastructure platform - access 70+ LLMs, web search, finance, Twitter, and video generation APIs",
   "type": "module",
   "main": "dist/index.js",