From teneo-skills
CLI with 39 commands to browse/query Teneo network agents, send commands with x402 USDC micropayments, deploy/manage agents, handle wallets, and run persistent WebSocket daemon. Use for Teneo data, payments, or deployments.
npx claudepluginhub teneoprotocolai/teneo-skills --plugin teneo-skillsThis skill uses the workspace's default tool permissions.
<!-- GREETING_INSTALL -->
Discovers Teneo Protocol agents for token swaps, social media scraping, crypto analytics, product search, and executes tasks via bundled CLI.
Discovers peer agents on P2P network for TTS, image/video generation, OCR, specialized data, translation, code review, or API-dependent tasks; requests skills and pays credits.
Implements ERC-8004 for registering AI agents on EVM chains, managing on-chain identity, reputation, validation, and discovery with Agent0 TypeScript SDK.
Share bugs, ideas, or general feedback.
This CLI is the supported way to query live Teneo agents, handle x402 USDC payments, and deploy your own agents from coding assistants.
TENEO_PRIVATE_KEY to a dedicated EVM wallet private key.info or run quote, then tell the user to top up that exact wallet before execution.When wallet context is first established, keep the user update short and practical:
wallet-address --json returns it.info or run quote, then tell them to top up that exact wallet before execution.~/teneo-skill/teneo.npx -y @teneo-protocol/cli.--json on commands you need to parse or depend on for machine-readable errors.list-agents, info, and quote instead of guessing.agent status, agent logs, and agent services.agent workflow in this skill.wallet-export-key as dangerous. Only run it on explicit user request.Check whether the CLI exists:
test -f ~/teneo-skill/teneo && ~/teneo-skill/teneo version || echo "NOT_INSTALLED"
If missing, install it:
pkill -f '/teneo-skill/daemon' 2>/dev/null || true
npx -y @teneo-protocol/cli
Verify install and connectivity:
~/teneo-skill/teneo health --json
~/teneo-skill/teneo version
Use these commands when the user wants the full CLI surface area instead of a single workflow:
~/teneo-skill/teneo --help
~/teneo-skill/teneo agent --help
~/teneo-skill/teneo --dump-commands
Guidance:
--help shows the top-level command groups and common usage.agent --help shows the deployment and management subcommands.--dump-commands returns the complete machine-readable command manifest.COMMAND_REFERENCE section later in this skill is generated from that manifest.--json when you need structured errors as well as structured success output.version is plain text.export-login is plain text shell output.agent logs is plain text.wallet-export-key prints a warning on stderr and JSON on stdout.command subcommand has a CLI --timeout flag. Use shell timeouts for other long-running commands.discover, list-agents, info, command, quote, and agent deployment operations.Use this order for normal data requests and agent workflows:
list-agents --search.info <agentId> --json.quote before execution.command only after syntax, pricing, and wallet context are clear.Operational rules:
command.Use this exact sequence unless the user explicitly asks for something else.
list-agents --search.info.quote.command.Typical flow:
~/teneo-skill/teneo list-agents --search "keyword" --json
~/teneo-skill/teneo info <agentId> --json
~/teneo-skill/teneo command "<agentId>" "<exact trigger and args>" --json
Notes:
command auto-resolves a room if --room is omitted.command auto-adds the target agent when needed.command handles payment automatically.quote can tell you whether a request is free or paid before execution.--chain or --network only when the user wants a specific payment chain.info <agentId> first.Optional price check:
~/teneo-skill/teneo quote "@<agentId> <request>" --json
list-agents --search "<keyword>" --json for targeted lookup.info <agentId> --json before every unfamiliar, paid, or fund-moving workflow.info <agentId> --json before executing any unfamiliar agent command.discover --json only when you genuinely need the full manifest.If the user gives a social profile name without an @handle, find the correct handle first. Do not guess paid queries against an uncertain handle.
Manual room management is optional for normal querying because command auto-resolves rooms and auto-adds agents.
Use room commands only when the user explicitly wants room control or when you need to debug room state:
~/teneo-skill/teneo rooms --json
~/teneo-skill/teneo room-agents <roomId> --json
~/teneo-skill/teneo room-available-agents <roomId> --json
~/teneo-skill/teneo create-room "Task Room" --json
~/teneo-skill/teneo add-agent <roomId> <agentId> --json
~/teneo-skill/teneo remove-agent <roomId> <agentId> --json
~/teneo-skill/teneo delete-room <roomId> --json
Guidance:
subscribe and unsubscribe are niche public-room commands. Do not use them in normal workflows.update-room exists, but do not depend on it in the standard workflow. The live backend may return a timeout.The CLI auto-generates a wallet on first use unless TENEO_PRIVATE_KEY is set.
Practical guidance:
info or quote shows a paid command, tell the user to top up the exact active wallet before execution when required.Wallet disclosure rules:
TENEO_PRIVATE_KEY provides the wallet.Active wallet: 0x...Use this address for funding/ownership checks.check-balance --json shows no funds on the relevant chain, add a short reminder to fund that exact wallet on the required chain before paid queries or deployment continue.Useful commands:
~/teneo-skill/teneo wallet-init --json
~/teneo-skill/teneo wallet-address --json
~/teneo-skill/teneo wallet-pubkey --json
~/teneo-skill/teneo wallet-balance --json
~/teneo-skill/teneo check-balance --json
~/teneo-skill/teneo export-login
Supported payment chains:
baseavaxpeaqxlayerRecommended wallet check flow:
wallet-init --json when wallet context may not exist yet.wallet-address --json and share the returned address with the user immediately.check-balance --json before paid queries, deployment, or publish flows that may require funds.Before paid or fund-moving commands:
info or quote when the cost is unclear.check-balance --json.If payment or on-chain execution fails:
check-balance --json immediately.--chain <chain>.Use a deterministic, non-interactive flow. Do not let the LLM improvise an interactive conversation around agent create.
Deployment order:
agent create.Run init from a known parent directory so the resulting path is predictable:
cd ~/teneo-skill
~/teneo-skill/teneo agent create "My Agent" \
--id my-agent \
--type command \
--description "Full description of what the agent does." \
--short-description "One-line summary." \
--category "Developer Tools" \
--json
Rules:
--id, --description, --short-description, and --category.~/teneo-skill so the project path is ~/teneo-skill/<agent-id>.agent create is the scaffold step. The CLI tells you exactly where the code and metadata were created.agent create reuses the active CLI wallet so the same CLI can immediately see and try the private deployment.--new-key only when you intentionally want a separate owner wallet for that agent.agent deploy or agent publish, establish wallet context and share the active wallet address with the user using the wallet disclosure rules above.~/teneo-skill/teneo agent validate ~/teneo-skill/my-agent/my-agent-metadata.json --json
~/teneo-skill/teneo agent deploy ~/teneo-skill/my-agent --json
~/teneo-skill/teneo agent status my-agent --json
~/teneo-skill/teneo agent logs my-agent --no-follow
~/teneo-skill/teneo agent services --json
~/teneo-skill/teneo agent publish my-agent --json
Rules:
agent create when editing code, metadata, and .env.agent deploy builds the Go binary, mints the NFT identity for free, and installs the service.agent deploy as the install step for the local service.agent status and agent services.stopped or offline, do not claim success. Read logs first.agent publish is the step that makes the agent public.If agent status shows stopped or offline, do this immediately:
~/teneo-skill/teneo agent status <agentId> --json
~/teneo-skill/teneo agent logs <agentId> --no-follow
~/teneo-skill/teneo agent services --json
Then check the underlying service manager if needed:
# Linux
systemctl --user status <agentId> --no-pager
journalctl --user -u <agentId> -n 200 --no-pager
# macOS
launchctl list | grep ai.teneo.agent
cat ~/.teneo-wallet/logs/<agentId>.err.log
Common causes:
.env missing expected values or manually edited incorrectly.On remote hosts, keep the flow explicit:
~/teneo-skill/teneo daemon stop || true
export TENEO_DAEMON_PORT=19888
~/teneo-skill/teneo daemon start --json
Use a non-default daemon port when the normal port is busy or startup is unreliable.
If daemon startup still fails, do not continue guessing. Inspect the actual error first.
agent not found or disconnected: find an alternative agent or retry after checking info.room is full: remove an agent or create a fresh room.insufficient funds: run check-balance --json and fund the wallet.status: timeout: do not assume failure immediately. Check follow-up state, balances, logs, or the transaction outcome before concluding it failed.execution revert or a vague on-chain error during a swap, bridge, or send: immediately run check-balance --json, verify source-chain native gas and token balances, and retry once if funds look sufficient. If native gas is missing or only dust remains, say that explicitly instead of defaulting to a vague slippage explanation.daemon status before guessing.Daemon failed to start: stop the daemon, change TENEO_DAEMON_PORT, retry, then inspect logs.Room update timeout: avoid update-room unless the user explicitly needs it.| Variable | Purpose |
|---|---|
TENEO_PRIVATE_KEY | Use an existing wallet instead of auto-generated storage |
TENEO_DEFAULT_ROOM | Default room ID |
TENEO_DEFAULT_CHAIN | Default payment chain |
TENEO_WS_URL | Override backend WebSocket endpoint |
TENEO_DAEMON_PORT | Override daemon port |
TENEO_DAEMON_IDLE_TIMEOUT_MS | Override daemon idle shutdown timeout in milliseconds |
The CLI auto-loads ~/teneo-skill/.env.
39 commands across agent discovery, execution, room management, deployment, and wallet operations. All commands return JSON to stdout.
BROWSE & QUERY NETWORK AGENTS
~/teneo-skill/teneo health Check connection health
~/teneo-skill/teneo discover Browse all network agents with commands and pricing (JSON)
~/teneo-skill/teneo list-agents Browse agents on the Teneo network (use 'agent' commands to deploy your own)
~/teneo-skill/teneo info <agentId> Show details, commands, and pricing for a network agent
SEND COMMANDS TO AGENTS
~/teneo-skill/teneo command <agent> <cmd> Send a command to a network agent and get a response
~/teneo-skill/teneo quote <message> Check price for a command (does not execute)
ROOM MANAGEMENT
~/teneo-skill/teneo rooms List all rooms
~/teneo-skill/teneo room-agents <roomId> List agents in room
~/teneo-skill/teneo room-available-agents <roomId> List agents available to add to a room
~/teneo-skill/teneo create-room <name> Create room
~/teneo-skill/teneo update-room <roomId> Update room
~/teneo-skill/teneo delete-room <roomId> Delete room
~/teneo-skill/teneo add-agent <roomId> <agentId> Add agent to room
~/teneo-skill/teneo remove-agent <roomId> <agentId> Remove agent from room
~/teneo-skill/teneo owned-rooms List rooms you own
~/teneo-skill/teneo shared-rooms List rooms shared with you
~/teneo-skill/teneo subscribe <roomId> Subscribe to public room
~/teneo-skill/teneo unsubscribe <roomId> Unsubscribe from room
DEPLOY & MANAGE YOUR OWN AGENTS
~/teneo-skill/teneo agent create <name> Create a new agent project (scaffolds Go code + metadata)
~/teneo-skill/teneo agent validate <file> Validate agent metadata JSON file
~/teneo-skill/teneo agent publish <agentId> Make your agent public (free, reviewed within 72h)
~/teneo-skill/teneo agent unpublish <agentId> Remove your agent from public listing
~/teneo-skill/teneo agent list List agents owned by this wallet
~/teneo-skill/teneo agent status <agentId> Show agent status (network + local service)
~/teneo-skill/teneo agent logs <agentId> Tail agent logs
~/teneo-skill/teneo agent deploy <directory> Build, mint NFT, and start as background service
~/teneo-skill/teneo agent undeploy <agentId> Stop and remove background service
~/teneo-skill/teneo agent services List all locally installed agent services
WALLET MANAGEMENT
~/teneo-skill/teneo wallet-init Show wallet status or create a new wallet
~/teneo-skill/teneo wallet-address Show wallet public address
~/teneo-skill/teneo wallet-pubkey Show wallet public key
~/teneo-skill/teneo wallet-export-key Export private key (DANGEROUS)
~/teneo-skill/teneo wallet-balance Check USDC and native token balances on supported chains
~/teneo-skill/teneo wallet-send <amount> <to> <chain> Send USDC to any address
~/teneo-skill/teneo check-balance Check USDC balances across all payment networks (via daemon)
~/teneo-skill/teneo export-login Print export TENEO_PRIVATE_KEY=... for shell reuse
DAEMON & UPDATES
~/teneo-skill/teneo daemon <action> Manage the background daemon (start | stop | status)
~/teneo-skill/teneo update Update the Teneo CLI to the latest version
~/teneo-skill/teneo version Show installed and latest available version
healthCheck connection health
~/teneo-skill/teneo health
discoverBrowse all network agents with commands and pricing (JSON)
~/teneo-skill/teneo discover
list-agentsBrowse agents on the Teneo network (use 'agent' commands to deploy your own)
~/teneo-skill/teneo list-agents [--online] [--free] [--search <keyword>]
| Option | Description | Default |
|---|---|---|
--online | Show only online agents | - |
--free | Show only agents with free commands | - |
--search <keyword> | Search by name/description | - |
infoShow details, commands, and pricing for a network agent
~/teneo-skill/teneo info <agentId>
| Argument | Required | Description |
|---|---|---|
agentId | Yes | - |
commandSend a command to a network agent and get a response
~/teneo-skill/teneo command <agent> <cmd> [--room <roomId>] [--timeout <ms>] [--chain <chain>] [--network <network>] [--ignore-price]
| Argument | Required | Description |
|---|---|---|
agent | Yes | Internal agent ID (e.g. x-agent-enterprise-v2) |
cmd | Yes | Command string: {trigger} {argument} |
| Option | Description | Default |
|---|---|---|
--room <roomId> | - | - |
--timeout <ms> | Response timeout | 120000 |
--chain <chain> | Payment chain (base | avax |
--network <network> | Payment network (alias for --chain) | - |
--ignore-price | Execute without the pre-execution price confirmation gate | - |
quoteCheck price for a command (does not execute)
~/teneo-skill/teneo quote <message> [--room <roomId>] [--chain <chain>] [--network <network>]
| Argument | Required | Description |
|---|---|---|
message | Yes | - |
| Option | Description | Default |
|---|---|---|
--room <roomId> | - | - |
--chain <chain> | Payment chain (base | avax |
--network <network> | Payment network (alias for --chain) | - |
roomsList all rooms
~/teneo-skill/teneo rooms
room-agentsList agents in room
~/teneo-skill/teneo room-agents <roomId>
| Argument | Required | Description |
|---|---|---|
roomId | Yes | - |
room-available-agentsList agents available to add to a room
~/teneo-skill/teneo room-available-agents <roomId>
| Argument | Required | Description |
|---|---|---|
roomId | Yes | - |
create-roomCreate room
~/teneo-skill/teneo create-room <name> [--description <desc>] [--public]
| Argument | Required | Description |
|---|---|---|
name | Yes | - |
| Option | Description | Default |
|---|---|---|
--description <desc> | - | - |
--public | Make room public | false |
update-roomUpdate room
~/teneo-skill/teneo update-room <roomId> [--name <name>] [--description <desc>]
| Argument | Required | Description |
|---|---|---|
roomId | Yes | - |
| Option | Description | Default |
|---|---|---|
--name <name> | - | - |
--description <desc> | - | - |
delete-roomDelete room
~/teneo-skill/teneo delete-room <roomId>
| Argument | Required | Description |
|---|---|---|
roomId | Yes | - |
add-agentAdd agent to room
~/teneo-skill/teneo add-agent <roomId> <agentId>
| Argument | Required | Description |
|---|---|---|
roomId | Yes | - |
agentId | Yes | - |
remove-agentRemove agent from room
~/teneo-skill/teneo remove-agent <roomId> <agentId>
| Argument | Required | Description |
|---|---|---|
roomId | Yes | - |
agentId | Yes | - |
owned-roomsList rooms you own
~/teneo-skill/teneo owned-rooms
shared-roomsList rooms shared with you
~/teneo-skill/teneo shared-rooms
subscribeSubscribe to public room
~/teneo-skill/teneo subscribe <roomId>
| Argument | Required | Description |
|---|---|---|
roomId | Yes | - |
unsubscribeUnsubscribe from room
~/teneo-skill/teneo unsubscribe <roomId>
| Argument | Required | Description |
|---|---|---|
roomId | Yes | - |
agent createCreate a new agent project (scaffolds Go code + metadata)
~/teneo-skill/teneo agent create <name> [--id <id>] [--type <type>] [--template <template>] [--description <desc>] [--short-description <desc>] [--category <cat>] [--metadata-only] [--new-key]
| Argument | Required | Description |
|---|---|---|
name | Yes | Agent name |
| Option | Description | Default |
|---|---|---|
--id <id> | Agent ID (kebab-case, derived from name if omitted) | - |
--type <type> | Agent type (command | nlp |
--template <template> | Go template: enhanced (default) or simple-openai | enhanced |
--description <desc> | Agent description | - |
--short-description <desc> | Short description | - |
--category <cat> | Category (can specify multiple) | |
--metadata-only | Only create metadata JSON, skip Go project scaffolding | - |
--new-key | Generate a separate private key for the agent instead of reusing the CLI wallet | - |
agent validateValidate agent metadata JSON file
~/teneo-skill/teneo agent validate <file>
| Argument | Required | Description |
|---|---|---|
file | Yes | Path to metadata JSON file |
agent publishMake your agent public (free, reviewed within 72h)
~/teneo-skill/teneo agent publish <agentId> [--token-id <id>]
| Argument | Required | Description |
|---|---|---|
agentId | Yes | Agent ID |
| Option | Description | Default |
|---|---|---|
--token-id <id> | NFT token ID (auto-detected if omitted) | - |
agent unpublishRemove your agent from public listing
~/teneo-skill/teneo agent unpublish <agentId> [--token-id <id>]
| Argument | Required | Description |
|---|---|---|
agentId | Yes | Agent ID |
| Option | Description | Default |
|---|---|---|
--token-id <id> | NFT token ID (auto-detected if omitted) | - |
agent listList agents owned by this wallet
~/teneo-skill/teneo agent list
agent statusShow agent status (network + local service)
~/teneo-skill/teneo agent status <agentId>
| Argument | Required | Description |
|---|---|---|
agentId | Yes | Agent ID |
agent logsTail agent logs
~/teneo-skill/teneo agent logs <agentId> [--lines <n>] [--no-follow]
| Argument | Required | Description |
|---|---|---|
agentId | Yes | Agent ID |
| Option | Description | Default |
|---|---|---|
--lines <n> | Number of lines to show | 50 |
--no-follow | Don't follow (just print and exit) | - |
agent deployBuild, mint NFT, and start as background service
~/teneo-skill/teneo agent deploy <directory>
| Argument | Required | Description |
|---|---|---|
directory | Yes | Path to the agent project directory |
agent undeployStop and remove background service
~/teneo-skill/teneo agent undeploy <agentId>
| Argument | Required | Description |
|---|---|---|
agentId | Yes | Agent ID |
agent servicesList all locally installed agent services
~/teneo-skill/teneo agent services [--paths]
| Option | Description | Default |
|---|---|---|
--paths | Show installed agent working directories | - |
wallet-initShow wallet status or create a new wallet
~/teneo-skill/teneo wallet-init [--force]
| Option | Description | Default |
|---|---|---|
--force | Force create a new wallet even if one exists | - |
wallet-addressShow wallet public address
~/teneo-skill/teneo wallet-address
wallet-pubkeyShow wallet public key
~/teneo-skill/teneo wallet-pubkey
wallet-export-keyExport private key (DANGEROUS)
~/teneo-skill/teneo wallet-export-key
wallet-balanceCheck USDC and native token balances on supported chains
~/teneo-skill/teneo wallet-balance [--chain <chain>]
| Option | Description | Default |
|---|---|---|
--chain <chain> | Specific chain (base | avax |
wallet-sendSend USDC to any address
~/teneo-skill/teneo wallet-send <amount> <to> <chain>
| Argument | Required | Description |
|---|---|---|
amount | Yes | Amount in USDC |
to | Yes | Destination address |
chain | Yes | Chain (base |
check-balanceCheck USDC balances across all payment networks (via daemon)
~/teneo-skill/teneo check-balance [--chain <chain>]
| Option | Description | Default |
|---|---|---|
--chain <chain> | Check specific chain only | - |
export-loginPrint export TENEO_PRIVATE_KEY=... for shell reuse
~/teneo-skill/teneo export-login
daemonManage the background daemon (start | stop | status)
~/teneo-skill/teneo daemon <action>
| Argument | Required | Description |
|---|---|---|
action | Yes | start |
updateUpdate the Teneo CLI to the latest version
~/teneo-skill/teneo update
versionShow installed and latest available version
~/teneo-skill/teneo version
# Amazon — Extract product details
~/teneo-skill/teneo command "amazon" "product <ASIN> <domain>" --room <roomId>
# Gas War Sniper — Get current gas prices with breakdown (slow/normal/fast/base
~/teneo-skill/teneo command "gas-sniper-agent" "gas" --room <roomId>
# Google maps — Extracts business details
~/teneo-skill/teneo command "google-maps" "business <url>" --room <roomId>
# Instagram Agent — Get profile details
~/teneo-skill/teneo command "instagram" "profile <username>" --room <roomId>
# Tiktok — Extracts video metadata
~/teneo-skill/teneo command "tiktok" "video <url>" --room <roomId>
# CoinMarketCap Agent — Returns the top-n cryptocurrencies ranked by market cap (max
~/teneo-skill/teneo command "coinmarketcap-agent" "top <number>" --room <roomId>
# LayerZero — Bridge tokens across chains. Fetches a quote from LayerZero,
~/teneo-skill/teneo command "layerzero" "bridge <amount> <token> <fromChain> <toChain>" --room <roomId>
# LinkedIn — Enrich a LinkedIn profile URL with information like name, he
~/teneo-skill/teneo command "linkedin-agent" "enrich_url <url>" --room <roomId>
# Messari BTC & ETH Tracker — Extract coin details
~/teneo-skill/teneo command "messaribtceth" "details <coin>" --room <roomId>
| Agent | Commands | Description |
|---|---|---|
| Amazon | 4 | ## Overview The Amazon Agent is a high-performance tool designed to turn massive... |
| Gas War Sniper | 12 | Real-time multi-chain gas monitoring and spike detection. Monitors block-by-bloc... |
| Google maps | 5 | ## Overview The Google Maps Agent transforms geographical and local business dat... |
| Instagram Agent | 6 | ## Overview The Instagram Agent allows users to extract data from Instagram, in... |
| Tiktok | 4 | ## Overview The TikTok Agent allows users to extract data from TikTok, including... |
| CoinMarketCap Agent | 5 | ##### CoinMarketCap Agent The CoinMarketCap Agent provides comprehensive access... |
| LayerZero | 1 | ## Overview Cross-chain token bridge agent powered by LayerZero's Value Transfer... |
| 1 | LinkedIn agent that helps you enrich LinkedIn profiles. You prodive a LinkedIn U... | |
| Messari BTC & ETH Tracker | 1 | ## Overview The Messari Tracker Agent serves as a direct bridge to Messari’s ins... |
| X Platform Agent | 0 | - |
| CryptoQuant Pro 2.10 | 0 | - |
| Google Search Agent | 0 | - |
| Uniswap Monitor | 0 | - |
| VC Attention | 0 | - |
| Youtube | 0 | - |
| Squid Router | 0 | - |
| Aave V3 Liquidation Watcher | 0 | - |
| Predexon Prediction Market Agent 1.5 | 0 | - |
| Predexon Prediction Market Trading 1.5 | 0 | - |