CLI reference

npm i -g @agenticstarter/cli
agentic help

Every command prints JSON. Errors return { "ok": false, "error": "…", "fix": "…" } — relay the fix to the user.

Command	What it does
agentic preflight	Checks RPC, launchpad address, signer, Agent ID, BNB balance and whether the launchpad is live
agentic list [--limit 20] / hot / new / near-grad / graduated	Token boards with price, mcap, 24h volume, progress
agentic token --token <addr>	One token: price, raised BNB, progress, PancakeSwap link after graduation
agentic quote --token <addr> --bnb <n>	Buy quote: tokens out, fee, refund if the 1% cap is hit
agentic quote --token <addr> --percent <p>	Sell quote (also --amount <tokens>, --all)
agentic buy --token <addr> --bnb <n> [--slippage 1]	Buy preview → requestId
agentic sell --token <addr> --percent <p>	Sell preview → requestId (also --amount, --all)
agentic create --name <n> --symbol <S> […]	Launch preview → requestId. Options: --description, --logo <https/ipfs URL or local file> (local PNG/JPG/GIF/WebP ≤1 MB is uploaded to IPFS for you), --website, --twitter, --telegram, --buy <bnb>
agentic ignite --token <addr> --percent <p> [--message "…"]	Burn tokens with an on-chain note (also --amount, --all). Preview → requestId; executes approve + ignite
agentic execute --request-id <id>	Broadcasts an approved preview. Valid 5 minutes, runs once
agentic tx --hash <0x…>	Decodes launchpad events in a transaction
agentic watch [--token <addr>] [--max-events n] [--timeout 30m]	Streams Created, Buy, Sell, Graduated as NDJSON
agentic config	Prints the active configuration

Environment

Variable	Default	Meaning
AGENTIC_CHAIN_ID	56	56 BNB Chain, 97 testnet
AGENTIC_RPC	public BNB Chain RPC	JSON-RPC endpoint
AGENTIC_LAUNCHPAD	built-in address	Override the launchpad contract
AGENTIC_IGNITE	built-in address	Override the IgniteBoard contract
AGENTIC_API	https://agenticstarter.xyz/api	Indexer API for boards
AGENTIC_SIGNER_CMD + AGENTIC_WALLET	—	External signer (see Signers)
AGENTIC_PRIVATE_KEY	—	Local key for testnet or a dedicated agent key
AGENTIC_HOME	~/.agentic	Where pending previews are stored

Example: buy flow

// agentic buy --token 0x0905…e50e --bnb 0.05
{
  "ok": true,
  "preview": { "action": "buy", "symbol": "BYTE", "tokensOut": 1802024.35, "minTokensOut": 1784004.1,
               "bnbSpent": 0.02586, "fee": 0.000259, "refund": 0.02414, "nearGraduation": false },
  "requestId": "966c59a5e4b4",
  "expiresInSeconds": 300
}

The refund here means the wallet reached the 1% cap; only 0.0259 BNB was used.