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

@crossmint/lobster-cli

v3.0.9

Published

Standalone CLI for lobster.cash Solana wallet operations. Agent-framework agnostic.

Vulnerabilities

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

Links

Git

Maintainers

pascualinopascualinopegidopaellapegidopaellamaxwellfortneymaxwellfortneyalfonso_paellaalfonso_paellaafeightafeightdevlyn-paelladevlyn-paellaalbertoelias-xmalbertoelias-xmguilleaszyn-crossmintguilleaszyn-crossmintmanuxmintmanuxmint

Keywords

crossmintsolanawalletclicryptoweb3lobster

Readme

@crossmint/lobster-cli

CLI that gives AI agents payment tools — a blockchain wallet on Solana, virtual credit cards for buying anything online, and x402 protocol support for paying APIs — all with secure guardrails and appropriate human controls. Maintained by Crossmint. Agent-framework agnostic.

Install

npm install @crossmint/lobster-cli

Quick start

# 1. Set up a wallet (opens consent URL for human approval)
lobstercash setup

# 2. Check balance
lobstercash crypto balance

# 3. Send USDC
lobstercash crypto send --to <address> --amount 10

For agents

If you are an AI agent using this CLI, read the skill files in skills/ before doing anything. Start with skills/SKILL.md — it contains the decision tree for routing to the correct reference.

Output contract:

  • All commands produce human-readable output to stdout
  • Errors go to stderr as plain text
  • Exit 0 = success, 1 = failure
  • Use lobstercash agents set-active to change the active agent

Global options

| Flag | Description | Default | | ---------------- | --------------- | -------------------------- | | --server <url> | Server base URL | https://www.lobster.cash | | --timeout <ms> | Request timeout | 15000 |

Commands

setup

Generate a local keypair and start the consent flow. Run again after approval to finalize.

lobstercash setup

status

Check agent status: wallet setup, balances, virtual cards, and payment readiness.

lobstercash status

examples

Show real, working examples of what agents can do with lobster.cash.

lobstercash examples

crypto balance

Check wallet balances.

lobstercash crypto balance

crypto send

Send tokens in a single step (create + sign + approve).

lobstercash crypto send --to <address> --amount <amount> [--token usdc] [--timeout 60000]

crypto deposit

Generate a deposit request URL for human approval. Bundles wallet setup if needed.

lobstercash crypto deposit --amount <amount> --description "<desc>"

crypto x402 fetch

Fetch an x402-protected URL, automatically handling payment.

lobstercash crypto x402 fetch <url> [--network mainnet-beta] [--json '<body>'] [--header "Key: Value"] [--debug]

crypto tx create

Create a transaction without approving it.

# Transfer
lobstercash crypto tx create --type transfer --to <address> --amount <amount> [--token usdc]

# Serialized transaction
lobstercash crypto tx create --type serialized --serialized-transaction <data>

# Contract calls
lobstercash crypto tx create --type calls --calls '<json array>'

crypto tx approve

Approve a pending transaction by signing.

# Let the CLI sign the message from tx create
lobstercash crypto tx approve --id <txId> --message <msg> [--encoding utf8]

# Or provide a pre-computed signature
lobstercash crypto tx approve --id <txId> --signature <sig>

crypto tx status

Check transaction status. Waits for a terminal state by default.

lobstercash crypto tx status --id <txId> [--timeout 60000]

cards request

Generate a virtual card request URL for human approval.

lobstercash cards request --amount <amount> --description "<description>"

cards list

List virtual card order intents for the agent wallet.

lobstercash cards list

cards reveal

Reveal virtual card credentials for a purchase.

lobstercash cards reveal --card-id <id> --merchant-name "<name>" --merchant-url "<url>" --merchant-country <XX>

Agent Management

Multiple agents are managed with lobstercash agents register, lobstercash agents list, and lobstercash agents set-active. Each agent has its own keypair, tokens, and smart wallet. Other commands use whichever agent is currently active.

agents register

Registers a new agent on the server and sets it as active locally.

lobstercash agents register --name <name> [--description <desc>] [--image-url <url>]

agents list

Lists all local agents and shows which is active.

lobstercash agents list

agents set-active

Sets the active agent.

lobstercash agents set-active <agentId>

Library usage

The package also exports all core functions for programmatic use:

import {
  parseConfig,
  getOrCreateWallet,
  ensureAuthenticated,
  withAuthenticatedApi,
  getWalletBalance,
  createTransaction,
  approveTransaction,
  runSetupFlow,
} from "@crossmint/lobster-cli";

See src/index.ts for the full list of exports.

Storage

Agent data and wallet keys are stored in ~/.lobster/agents.json (mode 0600). Override the directory with the LOBSTER_CASH_WALLETS_DIR environment variable. On first run, existing data is auto-migrated from wallets.json or the legacy path ~/.openclaw/lobster-cash/wallets.json.

Output

All commands produce human-readable output to stdout. Errors go to stderr as plain text.

License

MIT