This skill should be used when working with the 1Sat CLI tool for BSV operations from the terminal -- running wallet commands, minting ordinals, managing tokens, creating listings, locking BSV, sweeping assets, or managing identity from the command line. Triggers on '1sat CLI', 'command line wallet', '1sat init', '1sat wallet', '1sat ordinals', '1sat tokens', '1sat lock', '1sat sweep', '1sat action', 'bunx @1sat/cli', or 'terminal BSV operations'. Uses @1sat/cli package.
From 1satnpx claudepluginhub b-open-io/claude-plugins --plugin 1satThis skill uses the workspace's default tool permissions.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Executes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.
Guides idea refinement into designs: explores context, asks questions one-by-one, proposes approaches, presents sections for approval, writes/review specs before coding.
Bun-native command-line interface for 1Sat Ordinals and BSV operations. Binary name: 1sat.
# Run any command directly — no install needed
bunx @1sat/cli <command>
# Optional: install globally for frequent use
bun add -g @1sat/cli
# Then use the short form: 1sat <command>
# Initialize wallet and configuration
bunx @1sat/cli init
# Check wallet balance
bunx @1sat/cli wallet balance
# List ordinals in wallet
bunx @1sat/cli ordinals list
# Send BSV
bunx @1sat/cli wallet send --to 1Address... --amount 50000
If installed globally (
bun add -g @1sat/cli), replacebunx @1sat/cliwith just1sat.
Config directory: ~/.1sat/
Keys can be provided in three ways:
@1sat/vault — keys encrypted with SE P-256 key, decryption requires Touch ID. Used by bap touchid enable and clawnet setup-key.PRIVATE_KEY_WIF with your WIF private key~/.1sat/keys.bep (created during bunx @1sat/cli init)# Using env var
PRIVATE_KEY_WIF=L1abc... bunx @1sat/cli wallet balance
# Using encrypted keystore (created by init)
bunx @1sat/cli init
bunx @1sat/cli wallet balance
All examples below use
bunx @1sat/cli. If installed globally, use1satinstead.
bunx @1sat/cli wallet balance # Show BSV balance
bunx @1sat/cli wallet send # Send BSV to address
bunx @1sat/cli wallet send-all # Send entire balance
bunx @1sat/cli wallet utxos # List payment UTXOs
bunx @1sat/cli ordinals list # List ordinals in wallet
bunx @1sat/cli ordinals inscribe # Inscribe a file as ordinal
bunx @1sat/cli ordinals transfer # Transfer ordinal to recipient
bunx @1sat/cli ordinals list-for-sale # List ordinal for sale
bunx @1sat/cli ordinals cancel-listing # Cancel an active listing
bunx @1sat/cli ordinals purchase # Purchase a listed ordinal
bunx @1sat/cli tokens balances # Show all token balances
bunx @1sat/cli tokens list # List token UTXOs
bunx @1sat/cli tokens send # Send tokens to recipient
bunx @1sat/cli locks status # Show lock summary
bunx @1sat/cli locks create # Lock BSV until block height
bunx @1sat/cli locks unlock # Unlock all matured locks
bunx @1sat/cli identity publish # Publish BAP identity
bunx @1sat/cli identity profile # View/update profile
bunx @1sat/cli identity attest # Publish attestation
bunx @1sat/cli social post # Create a social post
bunx @1sat/cli social search # Search posts
bunx @1sat/cli opns register # Register identity on OpNS name
bunx @1sat/cli opns deregister # Remove identity binding
bunx @1sat/cli sweep bsv # Sweep BSV from external WIF
bunx @1sat/cli sweep ordinals # Sweep ordinals from external WIF
bunx @1sat/cli sweep tokens # Sweep BSV21 tokens from external WIF
Any registered action can be invoked directly by name with a JSON input:
# Run any action from the action registry
bunx @1sat/cli action <name> <json>
# Examples
bunx @1sat/cli action sendBsv '{"requests":[{"address":"1A...","satoshis":5000}]}'
bunx @1sat/cli action lockBsv '{"requests":[{"satoshis":10000,"until":900000}]}'
bunx @1sat/cli action inscribe '{"base64Content":"SGVsbG8=","contentType":"text/plain"}'
This is the escape hatch for any operation supported by the @1sat/actions registry, even those without dedicated CLI subcommands.
# JSON output (for scripting/piping)
bunx @1sat/cli wallet balance --json
# Quiet mode (minimal output)
bunx @1sat/cli wallet send --to 1A... --amount 5000 --quiet
# Auto-confirm prompts (non-interactive)
bunx @1sat/cli wallet send --to 1A... --amount 5000 --yes
bunx @1sat/cli init
The init command:
~/.1sat/keys.bep~/.1sat/config.jsonapi.1sat.appapi.1sat.app# Run without installing
bunx @1sat/cli
# Or install globally
bun add -g @1sat/cli
The CLI wraps @1sat/actions, @1sat/wallet-node, and @1sat/client into a single command-line interface.