Getting Started
Get up and running with spectra-tools in under a minute.
Requirements
- Node.js 20 or later
Quick start
The fastest way to try any CLI is with npx — no install needed:
npx @spectratools/assembly-cli statusYou'll see a live snapshot of Abstract's Assembly governance state, right in your terminal.
Install globally
If you use a CLI regularly, install it globally for faster access:
npm install -g @spectratools/assembly-clipnpm add -g @spectratools/assembly-cliyarn global add @spectratools/assembly-cliAfter installing, run commands directly:
assembly-cli statusChoose your CLI
Each CLI focuses on a different domain. Install only what you need:
🏛️ Assembly CLI — Governance on Abstract
Monitor proposals, council activity, treasury, and forum discussions.
npx @spectratools/assembly-cli governance proposals
npx @spectratools/assembly-cli treasury balance
npx @spectratools/assembly-cli members list🔍 Etherscan CLI — Multi-chain explorer data
Query balances, transactions, contracts, tokens, and gas across EVM chains.
npx @spectratools/etherscan-cli account balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum
npx @spectratools/etherscan-cli gas oracle --chain ethereum
npx @spectratools/etherscan-cli token info 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --chain ethereumRequires an Etherscan API key. Set it as ETHERSCAN_API_KEY.
📡 X API CLI — X (Twitter) automation
Search posts, pull timelines, manage lists, and send DMs.
npx @spectratools/xapi-cli posts search "abstract chain" --max-results 5
npx @spectratools/xapi-cli users get abstractchain
npx @spectratools/xapi-cli timeline home --max-results 10Requires X API credentials. Set X_BEARER_TOKEN for read access or X_ACCESS_TOKEN for full access.
🤖 ERC-8004 CLI — Agent identity & reputation preview
Explore trustless agent registries on Abstract. This CLI is in early preview — some commands may not work as expected.
npx @spectratools/erc8004-cli discovery search --service mcp --limit 5Configure API keys
Some CLIs need API keys or tokens. See the Configuration guide for the full list, organized by CLI.
Use with AI agents
All CLIs are built for agent consumption. Register any CLI as a skill or MCP server in one command:
assembly-cli skills add # register as agent skill
assembly-cli mcp add # register as MCP server
assembly-cli --llms # compact command index for discovery
assembly-cli --llms-full # full manifest with all details