Skip to content

Getting Started ​

Get up and running with spectra-tools in under a minute.

Requirements ​

Quick start ​

The fastest way to try any CLI is with npx — no install needed:

bash
npx @spectratools/assembly-cli status

You'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:

bash
npm install -g @spectratools/assembly-cli
bash
pnpm add -g @spectratools/assembly-cli
bash
yarn global add @spectratools/assembly-cli

After installing, run commands directly:

bash
assembly-cli status

Choose 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.

bash
npx @spectratools/assembly-cli governance proposals
npx @spectratools/assembly-cli treasury balance
npx @spectratools/assembly-cli members list

→ Assembly CLI docs

🔍 Etherscan CLI — Multi-chain explorer data ​

Query balances, transactions, contracts, tokens, and gas across EVM chains.

bash
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 ethereum

Requires an Etherscan API key. Set it as ETHERSCAN_API_KEY.

→ Etherscan CLI docs

📡 X API CLI — X (Twitter) automation ​

Search posts, pull timelines, manage lists, and send DMs.

bash
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 10

Requires X API credentials. Set X_BEARER_TOKEN for read access or X_ACCESS_TOKEN for full access.

→ X API CLI docs

🤖 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.

bash
npx @spectratools/erc8004-cli discovery search --service mcp --limit 5

→ ERC-8004 CLI docs

Configure 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:

bash
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

→ Agent integration guide