npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@polygonlabs/agent-cli

v0.3.0

Published

CLI + Agent Skills for building on-chain agents on Polygon

Downloads

1,003

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

devops-polygon.technologydevops-polygon.technologymtwardzickimtwardzickimaximushaximusmaximushaximuspy-zoidpy-zoid

Keywords

Readme

Polygon Agent CLI

Table of Contents

Overview

Polygon Agent CLI gives AI agents everything they need to operate onchain:

  • Create and manage wallets define allowances, session limits, and contract permissions in order to transact securely. Mitigates risk of prompt injection attacks. Private keys never leave the device and have to be exposed to your agent's context.
  • Send tokens, swap, bridge or any action pay in any token for any onchain action. Built-in swapping, bridging, deposits, DeFi primitives, and more.
  • Register agent identity and build reputation via ERC-8004
  • Integrated APIs query cross-chain balances, transaction history and or query nodes via dedicated RPCs
  • Payments first native gas abstraction built-in, pay end to end in stablecoins for interactions.

Quickstart

Recommended: Install on your agent

Install the Polygon Agent CLI as a skill your agent can use — works with Claude Code, Codex, Openclaw, and any agent harness that supports the skills protocol:

npx skills add https://github.com/0xPolygon/polygon-agent-cli

Once installed, your agent has access to wallet management, token operations, DEX swaps, and on-chain identity, all through the polygon-agent CLI.

Manual Install

npm (global):

npm install -g @polygonlabs/agent-cli

From source — for contributors or local development. Use pnpm polygon-agent instead of polygon-agent for all commands.

git clone https://github.com/0xPolygon/polygon-agent-cli.git
cd polygon-agent-cli
pnpm install
pnpm polygon-agent --help

After install: get your agent running

Once installed via skills or npm, run the following. If running from source, prefix polygon-agent commands with pnpm and run them from the root of the repository (e.g., pnpm polygon-agent setup --name "MyAgent").

# 1. Setup: creates EOA, authenticates, gets project access key
polygon-agent setup --name "MyAgent"

# 2. Set your access key
export SEQUENCE_PROJECT_ACCESS_KEY=<access-key>

# 3. Create a wallet (opens browser, auto-waits for approval)
polygon-agent wallet create

# 4. Fund the wallet
polygon-agent fund

# 5. Start operating (SEQUENCE_INDEXER_ACCESS_KEY is the same as your project access key)
export SEQUENCE_INDEXER_ACCESS_KEY=$SEQUENCE_PROJECT_ACCESS_KEY
polygon-agent balances
polygon-agent send --to 0x... --amount 1.0
polygon-agent swap --from USDC --to USDT --amount 5

# 6. Register your agent on-chain
polygon-agent agent register --name "MyAgent"

Omit --broadcast on any command to preview without sending. See QUICKSTART.md for the full step-by-step walkthrough.

Core Components

The CLI is built on three pillars to enable end to end onchain payments with your agents.

Sequence: Wallet Infrastructure

Sequence powers all wallet operations, RPC access, and indexing.

| Capability | What it does | CLI command | | ----------- | ------------------------------------------------------------------------------------------- | ------------------------------- | | Wallets | Session-based smart contract wallets (Account Abstraction) with scoped spending permissions | wallet create, wallet list | | RPCs | Load balanced RPCs cross-chain for onchain interactions and node queries | Used internally by all commands | | Indexer | Token balance queries and transaction history across ERC-20/721/1155 | balances |

Wallet sessions are created through a secure handshake between the CLI, the Connector UI, and the Sequence Ecosystem Wallet. Session permissions let you cap spending per token, whitelist contracts, and set time-based expiry and to mitigate against prompt injection attacks.

Trails: Swapping, Bridging, and DeFi Actions

Trails handles swapping, bridging, and onchain interactions enabling you to call any smart contract function and pay with any token. Trails handles it under the hood in a single transaction for your agent.

| Capability | What it does | CLI command | | ------------ | -------------------------------------------------------------------------------------------- | ------------------------------- | | Bridging | Move assets cross-chain into your Polygon wallet and fund the initial flows to your wallet | fund | | Swapping | Token swaps with configurable slippage seamlessly built in | swap | | Actions | Composable onchain operations (deposit into a DeFi vault, stake with your favorite protocol) | send, deposit, send-token |

Onchain Agentic Identity

Native contracts for agent identity, reputation, and emerging payment standards.

| Capability | What it does | CLI command | | --------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------ | | ERC-8004 | Register agents as ERC-721 NFTs with metadata and on-chain reputation | agent register, agent reputation, agent feedback | | x402 | HTTP-native micropayment protocol for agentic payments to your favorite services | x402-pay | | Native Apps | Direct interaction with smart contracts | Via --contract whitelisting |

ERC-8004 contracts on Polygon:

  • Identity Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
  • Reputation Registry: 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63

Plugins & Skills

The CLI ships with agent-friendly documentation designed to be consumed directly by AI agents.

| Distribution | How to install | | ------------------------------------------- | ----------------------------------------------------------- | | Skills (Claude Code, Codex, Openclaw, etc.) — recommended | npx skills add https://github.com/0xPolygon/polygon-agent-cli |

Once installed, the agent receives the full skill context — including wallet setup, token operations, and ERC-8004 registration, and can execute autonomously.

See SKILL.md for the full agent-consumable reference and QUICKSTART.md for the 4-phase setup guide.

CLI Reference

Setup & Wallets

polygon-agent setup --name <name>                 # Create EOA + project
polygon-agent wallet create                        # Create wallet (auto-wait)
polygon-agent wallet create --no-wait              # Manual approval flow
polygon-agent wallet list                          # Show all wallets
polygon-agent wallet address                       # Show wallet address
polygon-agent fund                                 # Open funding widget

Token Operations

polygon-agent balances                             # Check all balances
polygon-agent send --to 0x... --amount 1.0         # Send POL (dry-run)
polygon-agent send --symbol USDC --to 0x... --amount 10 --broadcast
polygon-agent swap --from USDC --to USDT --amount 5 --broadcast

Agent Registry (ERC-8004)

polygon-agent agent register --name "MyAgent" --broadcast
polygon-agent agent reputation --agent-id <id>
polygon-agent agent feedback --agent-id <id> --value 4.5 --broadcast
polygon-agent agent reviews --agent-id <id>

Smart Defaults

| Default | Value | Override | | ------------- | ---------------------- | -------------------- | | Wallet name | main | --name <name> | | Chain | polygon | --chain <name\|id> | | Wallet create | Auto-wait for approval | --no-wait | | Broadcast | Dry-run (preview) | --broadcast |

Environment Variables

One key covers everything: SEQUENCE_INDEXER_ACCESS_KEY and TRAILS_API_KEY are the same value as SEQUENCE_PROJECT_ACCESS_KEY:

export SEQUENCE_PROJECT_ACCESS_KEY=<access-key-from-setup>
export SEQUENCE_INDEXER_ACCESS_KEY=$SEQUENCE_PROJECT_ACCESS_KEY
export TRAILS_API_KEY=$SEQUENCE_PROJECT_ACCESS_KEY

Optional:

| Variable | Default | Description | | ---------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SEQUENCE_ECOSYSTEM_CONNECTOR_URL | https://agentconnect.polygon.technology/ | URL of the Connector UI that users open in a browser to approve wallet sessions. Override to point at a local dev server (http://localhost:4444) or a custom deployment. | | SEQUENCE_DAPP_ORIGIN | https://agentconnect.polygon.technology | Origin passed to the wallet during session creation. Identifies which dapp is requesting access. Override only if running the connector under a different domain. |

Security

  • Keys never leave the device. Credentials are encrypted at rest in ~/.polygon-agent/. Importantly, keys don't have to be exposed to the agent's context.
  • Session permissions are scoped. Per-session spending limits, contract whitelists, and 24-hour expiry.

Troubleshooting

| Issue | Fix | | ------------------------------------- | ----------------------------------- | | Missing SEQUENCE_PROJECT_ACCESS_KEY | Run setup first | | Session expired | Re-run wallet create | | Insufficient funds | Run fund to top up your wallet | | Transaction failed | Omit --broadcast to dry-run first | | Callback timeout | Increase with --timeout 600 |

Development

# Install dependencies
pnpm install

# CLI (via root script)
pnpm polygon-agent --help

# Connector UI
cd packages/connector-ui && pnpm dev

Project Structure

polygon-agent-cli/
├── packages/
│   ├── polygon-agent-cli/  # CLI package (@polygonlabs/agent-cli)
│   │   ├── src/            # TypeScript source
│   │   │   ├── index.ts    # yargs entry point
│   │   │   ├── commands/   # Command modules (setup, wallet, operations, agent)
│   │   │   ├── lib/        # Shared utils (storage, ethauth, tokens, dapp-client)
│   │   │   └── types.d.ts  # Ambient declarations for untyped deps
│   │   ├── contracts/      # ERC-8004 ABIs
│   │   └── skills/         # Agent-friendly docs (SKILL.md, QUICKSTART.md)
│   └── connector-ui/       # React app, wallet connect bridge
├── pnpm-workspace.yaml
└── package.json

Requirements: Node.js 20+

License

MIT