@tokenomist-ai/tokenomist-cli 0.1.1 → 0.2.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 tokenomist-ai contributors
+Copyright (c) 2026 Tokenomist
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -5,31 +5,22 @@
 
 CLI tool for the [Tokenomist API](https://tokenomist.ai) — query token unlocks, emissions, fundraising, burns, and buybacks from the terminal.
 
-## Quick Start (Internal)
+## Quick Start
 
 ```bash
-git clone https://github.com/tokenomist-ai/tokenomist-cli.git
-cd tokenomist-cli
-cp .env.example .env        # then edit .env with your API key and base URL
-npm install
-npm run build
-npm link
+npm install -g @tokenomist-ai/tokenomist-cli
 tok auth login
 tok token list
 ```
 
-## Installation
-
-```bash
-npm install -g @tokenomist-ai/tokenomist-cli
-```
-
-Or use without installing:
+Or run without installing:
 
 ```bash
 npx @tokenomist-ai/tokenomist-cli token list
 ```
 
+> **Requirements:** Node.js 18+ and a Tokenomist API key — get one at [tokenomist.ai](https://tokenomist.ai).
+
 ## Authentication
 
 Get an API key from [tokenomist.ai](https://tokenomist.ai) and configure it.
@@ -111,6 +102,7 @@ This reads the skill definitions from the local `.agents/skills/` directory inst
 | `tokenomist-fundraising-lookup` | Fundraising rounds, investors, and valuations |
 | `tokenomist-burn-buyback` | Token burn and buyback activity |
 | `tokenomist-allocation-breakdown` | Full allocation distribution for a token |
+| `tokenomist-point-in-time` | Tokenomics as published at a past version (history, audits, backtests) |
 
 ## Usage
 
@@ -164,6 +156,27 @@ tok emission weekly solana --start 2024-01-01 --end 2024-06-30
 tok allocation detail solana
 ```
 
+### Point-in-time history
+A token's data as it was published at a past version. Select the version with `--as-of` (a date or RFC 3339 instant) or `--version-id` (from `pit versions`), not both; omit both for the current version. Point-in-time answers carry no USD fields. Requires a plan with point-in-time access (API, ELITE or TEAM).
+
+```bash
+tok pit versions arbitrum
+tok pit allocation arbitrum --as-of 2024-01-01
+tok pit daily-emission arbitrum --as-of 2024-01-01 --start 2024-03-01 --end 2024-03-31
+tok pit unlock-events arbitrum --version-id <versionId> --output json
+```
+
+With `--output json`, `pit allocation`, `pit daily-emission` and `pit unlock-events` return `{ "asOf", "version", "data", "pagination" }` (`pagination` on the two series commands only); `pit versions` returns `{ "data", "pagination" }`.
+
+### Pagination
+Unlock, emission, investor list, burn list, buyback list, `pit versions` and the `pit` series commands return one page (20 rows by default). The page position is printed to **stderr**, so stdout stays clean for `--output json` / `csv`:
+
+```
+Page 1/2 · 28 total · next: --page 2 (or raise --page-size)
+```
+
+Use `--page` / `--page-size` to get the rest. A page past the last returns the last page again.
+
 ## Global Options
 
 | Option | Description |
@@ -171,6 +184,7 @@ tok allocation detail solana
 | `-k, --api-key <key>` | Override API key |
 | `-o, --output <format>` | Output format: `table` (default), `json`, `csv` |
 | `--base-url <url>` | Override API base URL (default: `https://api.tokenomist.ai`) |
+| `--no-cache` | Bypass the 10-minute response cache |
 | `-V, --version` | Print version |
 | `-h, --help` | Show help |
 

package/dist/chunk-DCGA3ANT.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+// package.json
+var package_default = {
+  name: "@tokenomist-ai/tokenomist-cli",
+  version: "0.2.0",
+  description: "CLI tool for the Tokenomist API \u2014 query token unlocks, emissions, fundraising, burns, buybacks, and point-in-time history from the terminal",
+  type: "module",
+  main: "dist/index.js",
+  bin: {
+    tok: "dist/index.js"
+  },
+  scripts: {
+    postinstall: "node scripts/postinstall.js",
+    build: "tsup",
+    dev: "tsup --watch",
+    start: "node dist/index.js",
+    test: "vitest run",
+    "test:watch": "vitest",
+    lint: "eslint src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix",
+    format: "prettier --write 'src/**/*.ts' 'tests/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts' 'tests/**/*.ts'",
+    prepublishOnly: "npm run build"
+  },
+  keywords: [
+    "tokenomist",
+    "crypto",
+    "token",
+    "unlock",
+    "emission",
+    "fundraising",
+    "burn",
+    "buyback",
+    "cli",
+    "api"
+  ],
+  author: {
+    name: "tokenomist-ai",
+    email: "support@tokenomist.ai",
+    url: "https://tokenomist.ai"
+  },
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/tokenomist-ai/tokenomist-cli.git"
+  },
+  homepage: "https://github.com/tokenomist-ai/tokenomist-cli#readme",
+  bugs: {
+    url: "https://github.com/tokenomist-ai/tokenomist-cli/issues"
+  },
+  engines: {
+    node: ">=18.0.0"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  files: [
+    "dist",
+    "skills/**",
+    "scripts/postinstall.js",
+    "LICENSE",
+    "README.md"
+  ],
+  dependencies: {
+    "cli-table3": "^0.6.5",
+    commander: "^12.1.0",
+    dotenv: "^16.4.7"
+  },
+  devDependencies: {
+    "@types/node": "^22.10.0",
+    eslint: "^9.16.0",
+    prettier: "^3.4.2",
+    tsup: "^8.3.5",
+    typescript: "^5.7.2",
+    "typescript-eslint": "^8.57.0",
+    vitest: "^3.2.4"
+  }
+};
+
+export {
+  package_default
+};
+//# sourceMappingURL=chunk-DCGA3ANT.js.map

package/dist/chunk-DCGA3ANT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../package.json"],"sourcesContent":["{\n  \"name\": \"@tokenomist-ai/tokenomist-cli\",\n  \"version\": \"0.2.0\",\n  \"description\": \"CLI tool for the Tokenomist API — query token unlocks, emissions, fundraising, burns, buybacks, and point-in-time history from the terminal\",\n  \"type\": \"module\",\n  \"main\": \"dist/index.js\",\n  \"bin\": {\n    \"tok\": \"dist/index.js\"\n  },\n  \"scripts\": {\n    \"postinstall\": \"node scripts/postinstall.js\",\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"start\": \"node dist/index.js\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"lint\": \"eslint src/ tests/\",\n    \"lint:fix\": \"eslint src/ tests/ --fix\",\n    \"format\": \"prettier --write 'src/**/*.ts' 'tests/**/*.ts'\",\n    \"format:check\": \"prettier --check 'src/**/*.ts' 'tests/**/*.ts'\",\n    \"prepublishOnly\": \"npm run build\"\n  },\n  \"keywords\": [\n    \"tokenomist\",\n    \"crypto\",\n    \"token\",\n    \"unlock\",\n    \"emission\",\n    \"fundraising\",\n    \"burn\",\n    \"buyback\",\n    \"cli\",\n    \"api\"\n  ],\n  \"author\": {\n    \"name\": \"tokenomist-ai\",\n    \"email\": \"support@tokenomist.ai\",\n    \"url\": \"https://tokenomist.ai\"\n  },\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/tokenomist-ai/tokenomist-cli.git\"\n  },\n  \"homepage\": \"https://github.com/tokenomist-ai/tokenomist-cli#readme\",\n  \"bugs\": {\n    \"url\": \"https://github.com/tokenomist-ai/tokenomist-cli/issues\"\n  },\n  \"engines\": {\n    \"node\": \">=18.0.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"files\": [\n    \"dist\",\n    \"skills/**\",\n    \"scripts/postinstall.js\",\n    \"LICENSE\",\n    \"README.md\"\n  ],\n  \"dependencies\": {\n    \"cli-table3\": \"^0.6.5\",\n    \"commander\": \"^12.1.0\",\n    \"dotenv\": \"^16.4.7\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^22.10.0\",\n    \"eslint\": \"^9.16.0\",\n    \"prettier\": \"^3.4.2\",\n    \"tsup\": \"^8.3.5\",\n    \"typescript\": \"^5.7.2\",\n    \"typescript-eslint\": \"^8.57.0\",\n    \"vitest\": \"^3.2.4\"\n  }\n}\n"],"mappings":";;;AAAA;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,aAAe;AAAA,EACf,MAAQ;AAAA,EACR,MAAQ;AAAA,EACR,KAAO;AAAA,IACL,KAAO;AAAA,EACT;AAAA,EACA,SAAW;AAAA,IACT,aAAe;AAAA,IACf,OAAS;AAAA,IACT,KAAO;AAAA,IACP,OAAS;AAAA,IACT,MAAQ;AAAA,IACR,cAAc;AAAA,IACd,MAAQ;AAAA,IACR,YAAY;AAAA,IACZ,QAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,gBAAkB;AAAA,EACpB;AAAA,EACA,UAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,QAAU;AAAA,IACR,MAAQ;AAAA,IACR,OAAS;AAAA,IACT,KAAO;AAAA,EACT;AAAA,EACA,SAAW;AAAA,EACX,YAAc;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,EACT;AAAA,EACA,UAAY;AAAA,EACZ,MAAQ;AAAA,IACN,KAAO;AAAA,EACT;AAAA,EACA,SAAW;AAAA,IACT,MAAQ;AAAA,EACV;AAAA,EACA,eAAiB;AAAA,IACf,QAAU;AAAA,EACZ;AAAA,EACA,OAAS;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,cAAgB;AAAA,IACd,cAAc;AAAA,IACd,WAAa;AAAA,IACb,QAAU;AAAA,EACZ;AAAA,EACA,iBAAmB;AAAA,IACjB,eAAe;AAAA,IACf,QAAU;AAAA,IACV,UAAY;AAAA,IACZ,MAAQ;AAAA,IACR,YAAc;AAAA,IACd,qBAAqB;AAAA,IACrB,QAAU;AAAA,EACZ;AACF;","names":[]}