@tokenomist-ai/tokenomist-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tokenomist-ai contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,176 @@
+# tokenomist-cli
+
+[![npm version](https://img.shields.io/npm/v/@tokenomist-ai/tokenomist-cli.svg)](https://www.npmjs.com/package/@tokenomist-ai/tokenomist-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+CLI tool for the [Tokenomist API](https://tokenomist.ai) — query token unlocks, emissions, fundraising, burns, and buybacks from the terminal.
+
+## Quick Start
+
+```bash
+npm install -g @tokenomist-ai/tokenomist-cli
+tokenomist auth login
+tokenomist token list
+```
+
+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.
+
+### `tokenomist auth login` (recommended)
+
+```bash
+tokenomist auth login
+# Enter your Tokenomist API key: ****
+
+# Or pass directly:
+tokenomist auth login --api-key your-api-key
+```
+
+This stores your key in `~/.tokenomist/config.json` with restricted file permissions (`0600`).
+
+### Check auth status
+
+```bash
+tokenomist auth status
+# Source:  ~/.tokenomist/config.json
+# Key:     tk-t****ab2f
+```
+
+### Remove stored key
+
+```bash
+tokenomist auth logout
+```
+
+### Alternative methods
+
+**Environment variable**
+```bash
+export TOKENOMIST_API_KEY=your-api-key
+```
+
+**`.env` file in project directory**
+```
+TOKENOMIST_API_KEY=your-api-key
+```
+
+**CLI flag (per-command)**
+```bash
+tokenomist token list --api-key your-api-key
+```
+
+### Resolution order
+
+`--api-key` flag > `TOKENOMIST_API_KEY` env var > `~/.tokenomist/config.json`
+
+## AI Skills
+
+Tokenomist CLI ships with AI coding skills that let agents (Claude Code, Cursor, Windsurf, etc.) query tokenomics data on your behalf.
+
+### Install skills
+
+```bash
+npx skills add tokenomist-ai/tokenomist-cli
+```
+
+### Available skills
+
+| Skill | Description |
+|-------|-------------|
+| `tokenomist-token-overview` | Browse all tracked tokens with market data |
+| `tokenomist-unlock-analysis` | Analyze upcoming and historical token unlocks |
+| `tokenomist-emission-report` | Daily/weekly emission data with allocation breakdowns |
+| `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 |
+
+## Usage
+
+### Token list
+```bash
+tokenomist token list
+tokenomist token list --output csv
+```
+
+### Unlock events
+```bash
+tokenomist unlock list
+tokenomist unlock list --min-market-cap 1000000
+tokenomist unlock upcoming
+tokenomist unlock events solana --start 2024-01-01 --end 2024-12-31
+```
+
+### Investors
+```bash
+tokenomist investor list
+tokenomist investor detail <investorId>
+tokenomist investor detail <investorId> --is-lead-investor
+```
+
+### Fundraising
+```bash
+tokenomist fundraising solana
+tokenomist fundraising solana --output json
+```
+
+### Burns
+```bash
+tokenomist burn list
+tokenomist burn detail solana --start 2024-01-01
+```
+
+### Buybacks
+```bash
+tokenomist buyback list
+tokenomist buyback detail solana
+```
+
+### Emissions
+```bash
+tokenomist emission daily solana
+tokenomist emission weekly solana --start 2024-01-01 --end 2024-06-30
+```
+
+### Allocations
+```bash
+tokenomist allocation solana
+```
+
+## Global Options
+
+| Option | Description |
+|--------|-------------|
+| `-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`) |
+| `-V, --version` | Print version |
+| `-h, --help` | Show help |
+
+## Development
+
+```bash
+git clone https://github.com/tokenomist-ai/tokenomist-cli.git
+cd tokenomist-cli
+npm install
+npm run build
+npm test
+
+# Link for local testing
+npm link
+tokenomist --help
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on filing issues and submitting pull requests.
+
+## License
+
+[MIT](LICENSE)