@tokenomist-ai/tokenomist-cli 0.1.0 → 0.1.1

package/dist/index.js

@@ -376,7 +376,7 @@ function resolveConfig(opts) {
   const baseUrl = opts.baseUrl || process.env.TOKENOMIST_BASE_URL || file.baseUrl || "https://api.tokenomist.ai";
   if (!apiKey) {
     console.error(
-      'Error: API key is required. Run "tokenomist auth login" or provide via --api-key / TOKENOMIST_API_KEY env var.'
+      'Error: API key is required. Run "tok auth login" or provide via --api-key / TOKENOMIST_API_KEY env var.'
     );
     process.exit(1);
   }
@@ -411,14 +411,18 @@ tokenCommand.command("list").description("List all tokens with summary data").op
   });
   output(data, columns, globalOpts.output || "table");
 });
-tokenCommand.command("search <query>").description("Search for tokens by name, symbol, or slug").action(async (query, _opts, cmd) => {
+tokenCommand.command("search <query>").description("Search for tokens by name, symbol, or ID").action(async (query, _opts, cmd) => {
   const globalOpts = cmd.optsWithGlobals();
   const config = resolveConfig(globalOpts);
   const client = new TokenomistClient(config.apiKey, config.baseUrl, {
     noCache: config.noCache
   });
   const data = await searchTokens(client, query);
-  output(data, searchColumns, globalOpts.output || "table");
+  output(
+    data,
+    searchColumns,
+    globalOpts.output || "table"
+  );
 });
 
 // src/commands/unlock.ts
@@ -434,9 +438,9 @@ async function listUpcomingUnlockEvents(client, params) {
     params
   );
 }
-async function getUnlockEvents(client, tokenSlug, params) {
+async function getUnlockEvents(client, tokenId, params) {
   return client.get(
-    `/v5/unlock/events/${encodeURIComponent(tokenSlug)}`,
+    `/v5/unlock/events/${encodeURIComponent(tokenId)}`,
     params
   );
 }
@@ -536,14 +540,14 @@ addUpcomingFilterOptions(
   );
 });
 addPaginationOptions(
-  unlockCommand.command("events <tokenSlug>").description("Get unlock events for a specific token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").option("--standard-allocation <names>", "Filter by allocation (comma-separated)")
-).action(async (tokenSlug, opts, cmd) => {
+  unlockCommand.command("events <tokenId>").description("Get unlock events for a specific token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").option("--standard-allocation <names>", "Filter by allocation (comma-separated)")
+).action(async (tokenId, opts, cmd) => {
   const globalOpts = cmd.optsWithGlobals();
   const config = resolveConfig(globalOpts);
   const client = new TokenomistClient(config.apiKey, config.baseUrl, {
     noCache: config.noCache
   });
-  const data = await getUnlockEvents(client, tokenSlug, {
+  const data = await getUnlockEvents(client, tokenId, {
     start: opts.start,
     end: opts.end,
     standardAllocation: opts.standardAllocation,
@@ -556,11 +560,7 @@ addPaginationOptions(
     cliffValue: d.cliffUnlocks.cliffValue,
     valueToMarketCap: d.cliffUnlocks.valueToMarketCap
   }));
-  output(
-    rows,
-    eventsColumns,
-    globalOpts.output || "table"
-  );
+  output(rows, eventsColumns, globalOpts.output || "table");
 });
 
 // src/commands/investor.ts
@@ -646,9 +646,9 @@ investorCommand.command("detail <investorId>").description("Get investor detail
 import { Command as Command4 } from "commander";
 
 // src/api/fundraising.ts
-async function getFundraising(client, tokenSlug, params) {
+async function getFundraising(client, tokenId, params) {
   return client.get(
-    `/v5/fundraising/token/${encodeURIComponent(tokenSlug)}`,
+    `/v5/fundraising/token/${encodeURIComponent(tokenId)}`,
     params
   );
 }
@@ -663,13 +663,16 @@ var columns2 = [
   { key: "pricePerToken", header: "Price/Token", align: "right" },
   { key: "numberOfInvestors", header: "Investors", align: "right" }
 ];
-var fundraisingCommand = new Command4("fundraising").description("Get fundraising data for a token").argument("<tokenSlug>", "Token slug").option("--funding-date-min <date>", "Min funding date (YYYY-MM-DD)").option("--funding-date-max <date>", "Max funding date (YYYY-MM-DD)").option("--raised-amount-min <value>", "Min raised amount").option("--raised-amount-max <value>", "Max raised amount").action(async (tokenSlug, opts, cmd) => {
+var fundraisingCommand = new Command4("fundraising").description(
+  "Token fundraising commands"
+);
+fundraisingCommand.command("detail <tokenId>").description("Get fundraising data for a specific token").option("--funding-date-min <date>", "Min funding date (YYYY-MM-DD)").option("--funding-date-max <date>", "Max funding date (YYYY-MM-DD)").option("--raised-amount-min <value>", "Min raised amount").option("--raised-amount-max <value>", "Max raised amount").action(async (tokenId, opts, cmd) => {
   const globalOpts = cmd.optsWithGlobals();
   const config = resolveConfig(globalOpts);
   const client = new TokenomistClient(config.apiKey, config.baseUrl, {
     noCache: config.noCache
   });
-  const data = await getFundraising(client, tokenSlug, {
+  const data = await getFundraising(client, tokenId, {
     fundingDateMin: opts.fundingDateMin,
     fundingDateMax: opts.fundingDateMax,
     raisedAmountMin: opts.raisedAmountMin,
@@ -694,9 +697,9 @@ import { Command as Command5 } from "commander";
 async function listBurns(client, params) {
   return client.get("/v5/burn/list", params);
 }
-async function getBurnDetail(client, tokenSlug, params) {
+async function getBurnDetail(client, tokenId, params) {
   return client.get(
-    `/v5/burn/${encodeURIComponent(tokenSlug)}`,
+    `/v5/burn/${encodeURIComponent(tokenId)}`,
     params
   );
 }
@@ -728,13 +731,13 @@ burnCommand.command("list").description("List all tokens with burn events").opti
   });
   output(data, listColumns3, globalOpts.output || "table");
 });
-burnCommand.command("detail <tokenSlug>").description("Get burn events for a specific token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").action(async (tokenSlug, opts, cmd) => {
+burnCommand.command("detail <tokenId>").description("Get burn events for a specific token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").action(async (tokenId, opts, cmd) => {
   const globalOpts = cmd.optsWithGlobals();
   const config = resolveConfig(globalOpts);
   const client = new TokenomistClient(config.apiKey, config.baseUrl, {
     noCache: config.noCache
   });
-  const data = await getBurnDetail(client, tokenSlug, {
+  const data = await getBurnDetail(client, tokenId, {
     start: opts.start,
     end: opts.end
   });
@@ -756,9 +759,9 @@ import { Command as Command6 } from "commander";
 async function listBuybacks(client, params) {
   return client.get("/v5/buyback/list", params);
 }
-async function getBuybackDetail(client, tokenSlug, params) {
+async function getBuybackDetail(client, tokenId, params) {
   return client.get(
-    `/v5/buyback/${encodeURIComponent(tokenSlug)}`,
+    `/v5/buyback/${encodeURIComponent(tokenId)}`,
     params
   );
 }
@@ -793,13 +796,13 @@ buybackCommand.command("list").description("List all tokens with buyback events"
   });
   output(data, listColumns4, globalOpts.output || "table");
 });
-buybackCommand.command("detail <tokenSlug>").description("Get buyback events for a specific token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").action(async (tokenSlug, opts, cmd) => {
+buybackCommand.command("detail <tokenId>").description("Get buyback events for a specific token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").action(async (tokenId, opts, cmd) => {
   const globalOpts = cmd.optsWithGlobals();
   const config = resolveConfig(globalOpts);
   const client = new TokenomistClient(config.apiKey, config.baseUrl, {
     noCache: config.noCache
   });
-  const data = await getBuybackDetail(client, tokenSlug, {
+  const data = await getBuybackDetail(client, tokenId, {
     start: opts.start,
     end: opts.end
   });
@@ -818,15 +821,15 @@ buybackCommand.command("detail <tokenSlug>").description("Get buyback events for
 import { Command as Command7 } from "commander";
 
 // src/api/emission.ts
-async function getDailyEmission(client, tokenSlug, params) {
+async function getDailyEmission(client, tokenId, params) {
   return client.get(
-    `/v5/daily-emission/${encodeURIComponent(tokenSlug)}`,
+    `/v5/daily-emission/${encodeURIComponent(tokenId)}`,
     params
   );
 }
-async function getWeeklyEmission(client, tokenSlug, params) {
+async function getWeeklyEmission(client, tokenId, params) {
   return client.get(
-    `/v5/emission/${encodeURIComponent(tokenSlug)}`,
+    `/v5/emission/${encodeURIComponent(tokenId)}`,
     params
   );
 }
@@ -843,13 +846,13 @@ var columns3 = [
   { key: "totalCumulativeUnlockedAmount", header: "Cumulative", align: "right" }
 ];
 var emissionCommand = new Command7("emission").description("Token emission commands");
-emissionCommand.command("daily <tokenSlug>").description("Get daily emission breakdown for a token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").option("--standard-allocation <names>", "Filter by allocation (comma-separated)").option("--page <number>", "Page number").option("--page-size <number>", "Items per page").action(async (tokenSlug, opts, cmd) => {
+emissionCommand.command("daily <tokenId>").description("Get daily emission breakdown for a token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").option("--standard-allocation <names>", "Filter by allocation (comma-separated)").option("--page <number>", "Page number").option("--page-size <number>", "Items per page").action(async (tokenId, opts, cmd) => {
   const globalOpts = cmd.optsWithGlobals();
   const config = resolveConfig(globalOpts);
   const client = new TokenomistClient(config.apiKey, config.baseUrl, {
     noCache: config.noCache
   });
-  const data = await getDailyEmission(client, tokenSlug, {
+  const data = await getDailyEmission(client, tokenId, {
     start: opts.start,
     end: opts.end,
     standardAllocation: opts.standardAllocation,
@@ -858,13 +861,13 @@ emissionCommand.command("daily <tokenSlug>").description("Get daily emission bre
   });
   output(data, columns3, globalOpts.output || "table");
 });
-emissionCommand.command("weekly <tokenSlug>").description("Get weekly emission breakdown for a token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").option("--standard-allocation <names>", "Filter by allocation (comma-separated)").option("--page <number>", "Page number").option("--page-size <number>", "Items per page").action(async (tokenSlug, opts, cmd) => {
+emissionCommand.command("weekly <tokenId>").description("Get weekly emission breakdown for a token").option("--start <date>", "Start date (YYYY-MM-DD)").option("--end <date>", "End date (YYYY-MM-DD)").option("--standard-allocation <names>", "Filter by allocation (comma-separated)").option("--page <number>", "Page number").option("--page-size <number>", "Items per page").action(async (tokenId, opts, cmd) => {
   const globalOpts = cmd.optsWithGlobals();
   const config = resolveConfig(globalOpts);
   const client = new TokenomistClient(config.apiKey, config.baseUrl, {
     noCache: config.noCache
   });
-  const data = await getWeeklyEmission(client, tokenSlug, {
+  const data = await getWeeklyEmission(client, tokenId, {
     start: opts.start,
     end: opts.end,
     standardAllocation: opts.standardAllocation,
@@ -878,10 +881,8 @@ emissionCommand.command("weekly <tokenSlug>").description("Get weekly emission b
 import { Command as Command8 } from "commander";
 
 // src/api/allocation.ts
-async function getAllocation(client, tokenSlug) {
-  return client.get(
-    `/v5/allocations/${encodeURIComponent(tokenSlug)}`
-  );
+async function getAllocation(client, tokenId) {
+  return client.get(`/v5/allocations/${encodeURIComponent(tokenId)}`);
 }
 
 // src/commands/allocation.ts
@@ -894,13 +895,14 @@ var columns4 = [
   { key: "allocationLockedAmount", header: "Locked", align: "right" },
   { key: "trackedAllocationPercentage", header: "Tracked %", align: "right" }
 ];
-var allocationCommand = new Command8("allocation").description("Get standard allocation data for a token").argument("<tokenSlug>", "Token slug").action(async (tokenSlug, _opts, cmd) => {
+var allocationCommand = new Command8("allocation").description("Token allocation commands");
+allocationCommand.command("detail <tokenId>").description("Get standard allocation data for a specific token").action(async (tokenId, _opts, cmd) => {
   const globalOpts = cmd.optsWithGlobals();
   const config = resolveConfig(globalOpts);
   const client = new TokenomistClient(config.apiKey, config.baseUrl, {
     noCache: config.noCache
   });
-  const data = await getAllocation(client, tokenSlug);
+  const data = await getAllocation(client, tokenId);
   const outputMode = globalOpts.output || "table";
   if (outputMode === "json") {
     console.log(JSON.stringify(data, null, 2));
@@ -970,7 +972,7 @@ authCommand.command("status").description("Show current authentication status").
     console.log(`Key:     ${maskApiKey(fileKey)}`);
   } else {
     console.log("Not authenticated.");
-    console.log(`Run "tokenomist auth login" to store your API key.`);
+    console.log(`Run "tok auth login" to store your API key.`);
   }
 });
 
@@ -979,7 +981,7 @@ import { Command as Command10 } from "commander";
 
 // src/schema.json
 var schema_default = {
-  name: "tokenomist",
+  name: "tok",
   version: "0.1.0",
   description: "CLI tool for the Tokenomist API",
   globalOptions: {
@@ -994,12 +996,12 @@ var schema_default = {
       options: {
         "token-id": { flags: "--token-id <ids>", description: "Filter by token IDs (comma-separated)" }
       },
-      example: "tokenomist token list --output json"
+      example: "tok token list --output json"
     },
     "token search <query>": {
-      description: "Search for tokens by name, symbol, or slug",
+      description: "Search for tokens by name, symbol, or ID",
       arguments: { query: { required: true, description: "Search query string" } },
-      example: "tokenomist token search bitcoin --output json"
+      example: "tok token search bitcoin --output json"
     },
     "unlock list": {
       description: "List unlock events grouped by token",
@@ -1014,7 +1016,7 @@ var schema_default = {
         page: { flags: "--page <number>", description: "Page number" },
         "page-size": { flags: "--page-size <number>", description: "Items per page" }
       },
-      example: "tokenomist unlock list --min-market-cap 1000000"
+      example: "tok unlock list --min-market-cap 1000000"
     },
     "unlock upcoming": {
       description: "List next upcoming unlock event per token",
@@ -1029,11 +1031,11 @@ var schema_default = {
         page: { flags: "--page <number>", description: "Page number" },
         "page-size": { flags: "--page-size <number>", description: "Items per page" }
       },
-      example: "tokenomist unlock upcoming --output json"
+      example: "tok unlock upcoming --output json"
     },
-    "unlock events <tokenSlug>": {
+    "unlock events <tokenId>": {
       description: "Get unlock events for a specific token",
-      arguments: { tokenSlug: { required: true, description: "Token slug (e.g. solana)" } },
+      arguments: { tokenId: { required: true, description: "Token ID (e.g. solana)" } },
       options: {
         start: { flags: "--start <date>", description: "Start date (YYYY-MM-DD)" },
         end: { flags: "--end <date>", description: "End date (YYYY-MM-DD)" },
@@ -1041,7 +1043,7 @@ var schema_default = {
         page: { flags: "--page <number>", description: "Page number" },
         "page-size": { flags: "--page-size <number>", description: "Items per page" }
       },
-      example: "tokenomist unlock events solana --start 2024-01-01 --end 2024-12-31"
+      example: "tok unlock events solana --start 2024-01-01 --end 2024-12-31"
     },
     "investor list": {
       description: "List all investors",
@@ -1051,7 +1053,7 @@ var schema_default = {
         page: { flags: "--page <number>", description: "Page number" },
         "page-size": { flags: "--page-size <number>", description: "Items per page" }
       },
-      example: "tokenomist investor list --output json"
+      example: "tok investor list --output json"
     },
     "investor detail <investorId>": {
       description: "Get investor portfolio and funding rounds",
@@ -1063,18 +1065,18 @@ var schema_default = {
         "raised-amount-min": { flags: "--raised-amount-min <amount>", description: "Minimum raised amount" },
         "raised-amount-max": { flags: "--raised-amount-max <amount>", description: "Maximum raised amount" }
       },
-      example: "tokenomist investor detail 123 --is-lead-investor"
+      example: "tok investor detail 123 --is-lead-investor"
     },
-    "fundraising <tokenSlug>": {
-      description: "Get fundraising data for a token",
-      arguments: { tokenSlug: { required: true, description: "Token slug" } },
+    "fundraising detail <tokenId>": {
+      description: "Get fundraising data for a specific token",
+      arguments: { tokenId: { required: true, description: "Token ID" } },
       options: {
         "funding-date-min": { flags: "--funding-date-min <date>", description: "Minimum funding date" },
         "funding-date-max": { flags: "--funding-date-max <date>", description: "Maximum funding date" },
         "raised-amount-min": { flags: "--raised-amount-min <amount>", description: "Minimum raised amount" },
         "raised-amount-max": { flags: "--raised-amount-max <amount>", description: "Maximum raised amount" }
       },
-      example: "tokenomist fundraising uniswap --output json"
+      example: "tok fundraising detail uniswap --output json"
     },
     "burn list": {
       description: "List all tokens with burn data",
@@ -1083,16 +1085,16 @@ var schema_default = {
         page: { flags: "--page <number>", description: "Page number" },
         "page-size": { flags: "--page-size <number>", description: "Items per page" }
       },
-      example: "tokenomist burn list --output json"
+      example: "tok burn list --output json"
     },
-    "burn detail <tokenSlug>": {
+    "burn detail <tokenId>": {
       description: "Get burn events for a specific token",
-      arguments: { tokenSlug: { required: true, description: "Token slug" } },
+      arguments: { tokenId: { required: true, description: "Token ID" } },
       options: {
         start: { flags: "--start <date>", description: "Start date" },
         end: { flags: "--end <date>", description: "End date" }
       },
-      example: "tokenomist burn detail solana --start 2024-01-01"
+      example: "tok burn detail solana --start 2024-01-01"
     },
     "buyback list": {
       description: "List all tokens with buyback data",
@@ -1101,20 +1103,20 @@ var schema_default = {
         page: { flags: "--page <number>", description: "Page number" },
         "page-size": { flags: "--page-size <number>", description: "Items per page" }
       },
-      example: "tokenomist buyback list --output json"
+      example: "tok buyback list --output json"
     },
-    "buyback detail <tokenSlug>": {
+    "buyback detail <tokenId>": {
       description: "Get buyback events for a specific token",
-      arguments: { tokenSlug: { required: true, description: "Token slug" } },
+      arguments: { tokenId: { required: true, description: "Token ID" } },
       options: {
         start: { flags: "--start <date>", description: "Start date" },
         end: { flags: "--end <date>", description: "End date" }
       },
-      example: "tokenomist buyback detail solana --output json"
+      example: "tok buyback detail solana --output json"
     },
-    "emission daily <tokenSlug>": {
+    "emission daily <tokenId>": {
       description: "Get daily emission data for a token",
-      arguments: { tokenSlug: { required: true, description: "Token slug" } },
+      arguments: { tokenId: { required: true, description: "Token ID" } },
       options: {
         start: { flags: "--start <date>", description: "Start date" },
         end: { flags: "--end <date>", description: "End date" },
@@ -1122,11 +1124,11 @@ var schema_default = {
         page: { flags: "--page <number>", description: "Page number" },
         "page-size": { flags: "--page-size <number>", description: "Items per page" }
       },
-      example: "tokenomist emission daily arbitrum --start 2024-08-01 --end 2024-08-31"
+      example: "tok emission daily arbitrum --start 2024-08-01 --end 2024-08-31"
     },
-    "emission weekly <tokenSlug>": {
+    "emission weekly <tokenId>": {
       description: "Get weekly emission data for a token",
-      arguments: { tokenSlug: { required: true, description: "Token slug" } },
+      arguments: { tokenId: { required: true, description: "Token ID" } },
       options: {
         start: { flags: "--start <date>", description: "Start date" },
         end: { flags: "--end <date>", description: "End date" },
@@ -1134,34 +1136,34 @@ var schema_default = {
         page: { flags: "--page <number>", description: "Page number" },
         "page-size": { flags: "--page-size <number>", description: "Items per page" }
       },
-      example: "tokenomist emission weekly arbitrum --start 2024-01-01 --end 2024-06-30"
+      example: "tok emission weekly arbitrum --start 2024-01-01 --end 2024-06-30"
     },
-    "allocation <tokenSlug>": {
-      description: "Get standard allocation distribution for a token",
-      arguments: { tokenSlug: { required: true, description: "Token slug" } },
-      example: "tokenomist allocation solana --output json"
+    "allocation detail <tokenId>": {
+      description: "Get standard allocation data for a specific token",
+      arguments: { tokenId: { required: true, description: "Token ID" } },
+      example: "tok allocation detail solana --output json"
     },
     "auth login": {
       description: "Store API key",
       options: {
         "api-key": { flags: "--api-key <key>", description: "API key (prompts if not provided)" }
       },
-      example: "tokenomist auth login"
+      example: "tok auth login"
     },
     "auth logout": {
       description: "Remove stored API key",
-      example: "tokenomist auth logout"
+      example: "tok auth logout"
     },
     "auth status": {
       description: "Show current auth status",
-      example: "tokenomist auth status"
+      example: "tok auth status"
     },
     schema: {
       description: "Print full command schema as JSON",
       options: {
         pretty: { flags: "--pretty", description: "Pretty-print with 2-space indent" }
       },
-      example: "tokenomist schema --pretty"
+      example: "tok schema --pretty"
     }
   }
 };
@@ -1172,6 +1174,58 @@ var schemaCommand = new Command10("schema").description("Print full command sche
   console.log(JSON.stringify(schema_default, null, indent));
 });
 
+// src/banner.ts
+var BANNER_COLOR_OPEN = "\x1B[38;2;197;16;82m";
+var COLOR_RESET = "\x1B[0m";
+var BANNER = `\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557
+\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D
+   \u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2551
+   \u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551
+   \u2588\u2588\u2551   \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551
+   \u255A\u2550\u255D    \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D     \u255A\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D   \u255A\u2550\u255D   `;
+var WELCOME_LINES = [
+  "Welcome to tokenomist-cli v0.1.0",
+  "Query token unlocks, emissions, fundraising, burns, and buybacks from the terminal.",
+  "",
+  " Getting started:",
+  "",
+  " $ tok auth login                                # store your API key",
+  " $ tok token list                                # list all tracked tokens",
+  " $ tok token search bitcoin                      # query tokens by name / symbol",
+  " $ npx skills add tokenomist-ai/tokenomist-cli   # install AI coding skills",
+  " $ tok --help                                    # for view more commands",
+  "",
+  "Docs:   https://docs.tokenomist.ai/",
+  "Site:   https://tokenomist.ai",
+  "Issues: https://github.com/tokenomist-ai/tokenomist-cli/issues"
+];
+function shouldUseColor(stream) {
+  if (process.env.NO_COLOR !== void 0 && process.env.NO_COLOR !== "") return false;
+  if (process.env.FORCE_COLOR === "0") return false;
+  return Boolean(stream.isTTY);
+}
+function frame(lines, colored) {
+  const innerWidth = Math.max(...lines.map((l) => l.length));
+  const horizontal = "\u2500".repeat(innerWidth + 2);
+  const open = colored ? BANNER_COLOR_OPEN : "";
+  const close = colored ? COLOR_RESET : "";
+  const top = `${open}\u256D${horizontal}\u256E${close}`;
+  const bottom = `${open}\u2570${horizontal}\u256F${close}`;
+  const side = `${open}\u2502${close}`;
+  const middle = lines.map((l) => `${side} ${l.padEnd(innerWidth)} ${side}`);
+  return [top, ...middle, bottom].join("\n");
+}
+function printWelcome(stream) {
+  const colored = shouldUseColor(stream);
+  const banner = colored ? `${BANNER_COLOR_OPEN}${BANNER}${COLOR_RESET}` : BANNER;
+  stream.write(`${banner}
+
+`);
+  stream.write(`${frame(WELCOME_LINES, colored)}
+
+`);
+}
+
 // src/index.ts
 import { spawn } from "child_process";
 import { readFileSync as readFileSync3 } from "fs";
@@ -1195,6 +1249,14 @@ Update available: ${data.current} \u2192 ${data.latest}  (npm i -g @tokenomist-a
   } catch {
   }
 }
+function showWelcomeBanner() {
+  if (process.env.TOKENOMIST_NO_BANNER === "1") return false;
+  if (process.env.CI === "1") return false;
+  if (!process.stderr.isTTY) return false;
+  if (process.argv.length > 2) return false;
+  printWelcome(process.stderr);
+  return true;
+}
 function spawnUpdateCheck() {
   if (process.env.NO_UPDATE_NOTIFIER === "1" || process.env.CI === "1") return;
   try {
@@ -1204,7 +1266,7 @@ function spawnUpdateCheck() {
   }
 }
 var program = new Command11();
-program.name("tokenomist").description(
+program.name("tok").description(
   "CLI tool for the Tokenomist API \u2014 query token unlocks, emissions, fundraising, burns, and buybacks"
 ).version("0.1.0").option("-k, --api-key <key>", "API key (overrides env/config)").option("-o, --output <format>", "Output format: table, json, csv", "table").option("--base-url <url>", "API base URL").option("--no-cache", "Bypass response cache");
 program.addCommand(tokenCommand);
@@ -1217,6 +1279,10 @@ program.addCommand(emissionCommand);
 program.addCommand(allocationCommand);
 program.addCommand(authCommand);
 program.addCommand(schemaCommand);
+if (showWelcomeBanner()) {
+  spawnUpdateCheck();
+  process.exit(0);
+}
 showUpdateNotification();
 program.parseAsync(process.argv).then(() => {
   spawnUpdateCheck();