@four-meme/four-meme-ai 1.0.1 → 1.0.3

package/bin/fourmeme.cjs

@@ -1,12 +1,16 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * fourmeme CLI - dispatches to four-meme-integration scripts.
  * Usage: fourmeme <command> [args...]
  * Run "fourmeme --help" for commands.
+ * Loads .env from current working directory (where you run fourmeme) if present.
  */
 const { spawnSync } = require('child_process');
 const path = require('path');
 
+// Load .env from cwd (e.g. your project dir) so PRIVATE_KEY, BSC_RPC_URL etc. work when running from a project
+require('dotenv').config({ path: path.join(process.cwd(), '.env') });
+
 const root = path.join(__dirname, '..');
 const scriptsDir = path.join(root, 'skills', 'four-meme-integration', 'scripts');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@four-meme/four-meme-ai",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Four.meme AI skills for creating and trading meme tokens (BSC only)",
   "license": "MIT",
   "type": "module",
@@ -42,6 +42,9 @@
     "skill",
     "openclaw"
   ],
+  "dependencies": {
+    "dotenv": "^16.0.0"
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "tsx": "^4.20.0",

package/skills/four-meme-integration/SKILL.md

@@ -12,7 +12,7 @@ description: |
   - Querying TaxToken fee/tax config on-chain (BSC only)
   - **Discover → detail → quote → execute**: use token-rankings / token-list / events to find tokens → token-get / token-info for details → quote-buy / quote-sell to estimate → buy / sell to execute (see "Agent workflow: buy/sell from rankings or events" below).
 
-  BSC only (Arbitrum/Base not supported). Requires npm install. Create/chain need PRIVATE_KEY. TokenManager V1 not supported.
+  BSC only (Arbitrum/Base not supported). **Before use, the fourmeme CLI must be installed** (e.g. `npm install -g @four-meme/four-meme-ai@latest`). Create/chain need PRIVATE_KEY. TokenManager V1 not supported.
   **OpenClaw**: PRIVATE_KEY and BSC_RPC_URL are declared in metadata and injected by OpenClaw only when this skill is **enabled** (only this skill can access them). **Two steps required**: (1) Configure private key in the skill’s `apiKey` or `skills.entries["four-meme-ai"].env`; (2) **Enable this skill** in the agent/session so OpenClaw injects the env. See "PRIVATE_KEY and BSC_RPC_URL" below.
 allowed-tools:
   - Bash(fourmeme *)
@@ -95,6 +95,16 @@ See the **CLI (fourmeme)** table and sections below for commands and arguments.
 
 BSC only; all commands output JSON. Run `fourmeme --help` for usage.
 
+## Installation (required before use)
+
+**You must install the fourmeme CLI before using this skill.** Recommended (global):
+
+```bash
+npm install -g @four-meme/four-meme-ai@latest
+```
+
+After installation, run commands with `fourmeme <command> [args]`. If you use a local install instead, use `npx fourmeme <command> [args]` from the project root.
+
 This skill provides: token creation (API + chain), buy/sell quotes and execution, token info/list/rankings, event listening, Tax token fee queries, send, and EIP-8004 identity NFT register and balance. Contract addresses and version notes: [references/contract-addresses.md](references/contract-addresses.md). **TokenManager V1 is not supported in this skill.**
 
 ## Create token flow
@@ -153,7 +163,7 @@ When the user asks to “buy/sell based on rankings or activity”, the Agent sh
 
 ## CLI (fourmeme)
 
-Run `npx fourmeme --help` for usage. From project root after `npm install`, use **`npx fourmeme <command> [args]`** (local install does not add `fourmeme` to PATH; use `npm link` for global `fourmeme`).
+Run `fourmeme --help` for usage. After **global install** (`npm install -g @four-meme/four-meme-ai@latest`), use **`fourmeme <command> [args]`**. With a local install only, use **`npx fourmeme <command> [args]`** from the project root.
 
 ### PRIVATE_KEY and BSC_RPC_URL
 
@@ -167,7 +177,7 @@ This skill declares `requires.env: ["PRIVATE_KEY"]` and `primaryEnv: "PRIVATE_KE
 **When not using OpenClaw (standalone)**  
 Set **PRIVATE_KEY** (or **FOURMEME_PRIVATE_KEY**) and optionally **BSC_RPC_URL** via the process environment so they are available when running `npx fourmeme` or `node bin/fourmeme.cjs`:
 
-- **.env file**: Create a `.env` file in the project root with lines like `PRIVATE_KEY=...` and `BSC_RPC_URL=...`. The CLI scripts do not load `.env` automatically; you must load it before running (e.g. `export $(cat .env | xargs)` or a tool that injects `.env` into the process). Do not commit `.env`; add it to `.gitignore`.
+- **.env file**: Put a `.env` file in **the directory where you run the `fourmeme` command** (i.e. your project / working directory). Example: if you run `fourmeme quote-buy ...` from `/path/to/my-project`, place `.env` at `/path/to/my-project/.env`. The CLI automatically loads `.env` from that current working directory. Use lines like `PRIVATE_KEY=...` and `BSC_RPC_URL=...`. Do not commit `.env`; add it to `.gitignore`.
 - **Shell export**: `export PRIVATE_KEY=your_hex_key` and `export BSC_RPC_URL=https://bsc-dataseed.binance.org` (or another BSC RPC), then run `npx fourmeme <command> ...`.
 
 | Need | Command | When |
@@ -438,3 +448,4 @@ See [references/tax-token-query.md](references/tax-token-query.md).
 | [execute-trade.md](references/execute-trade.md) | Execute buy/sell CLI and contract usage |
 | [event-listening.md](references/event-listening.md) | TokenManager2 event listening (V2) |
 | [tax-token-query.md](references/tax-token-query.md) | TaxToken on-chain fee/tax query (tax-info) |
+| **Official four.meme API and contracts (online)**: [Protocol Integration](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) | API documents, ABIs: TokenManager, TokenManager2, Helper3, TaxToken, etc. |