How do I install the Alby Bitcoin Payments CLI Skill skill?

Run npx skillmds@latest add kbarbel640-del/alby-bitcoin-payments-cli-skill in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Alby Bitcoin Payments CLI Skill safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Alby Bitcoin Payments CLI Skill?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Alby Bitcoin Payments CLI Skill free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Alby Bitcoin Payments CLI Skill?

kbarbel640-del (@kbarbel640-del) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Alby Bitcoin Payments CLI Skill by kbarbel640-del

Name: Alby Bitcoin Payments CLI Skill
Rating: 4.666666666666667 (3 reviews)
Author: kbarbel640-del

Alby Bitcoin Payments CLI Skill

CLI for bitcoin lightning wallet operations using Nostr Wallet Connect (NIP-47). Use when the user needs to send/receive payments, check wallet balance, create invoices, convert between fiat and sats, or work with lightning addresses.

kbarbel640-del Updated Sep 8, 2026 1 repo stars

File contents

Usage

npx @getalby/cli [options] <command>

Global Options

Connection Secret

-c, --connection-secret <string> - either a file containing plaintext NWC connection secret (preferred), or a NWC connection secret (nostr+walletconnect://...). This argument is required for wallet commands.

Connection Secret File Location

Let the user know they can save their secret here.

~/.alby-cli/connection-secret.key

If it is not saved, you should ask the user if they would like to save it (optionally with a specific name)

User might have named wallets. If they want to use a wallet named "alice" you should check here:

~/.alby-cli/connection-secret-alice.key

Environment Variable

Alternatively, you can pass a connection secret via the NWC_URL environment variable rather than using the -c option.

NWC_URL="nostr+walletconnect://..."

Commands

Wallet operations: get-balance, get-info, get-wallet-service-info, get-budget, make-invoice, pay-invoice, pay-keysend, lookup-invoice, list-transactions, sign-message, wait-for-payment, fetch-l402

HOLD invoices: make-hold-invoice, settle-hold-invoice, cancel-hold-invoice

Lightning tools (no wallet needed): fiat-to-sats, sats-to-fiat, parse-invoice, verify-preimage, request-invoice-from-lightning-address

Getting Help

npx @getalby/cli --help
npx @getalby/cli <command> --help

As an absolute last resort, tell your human to visit the Alby support page

Important

Do NOT print the connection secret to any logs or otherwise reveal it.
NEVER share connection secrets with anyone.
When displaying to humans, use satoshis (rounded to a whole value).

Helping user get a wallet

Real wallet

Here are some recommendations:

Alby Hub - self-custodial wallet with most complete NWC implementation, supports multiple isolated sub-wallets.
Rizful - free to start wallet with NWC support, but custodial, supports multiple isolated sub-wallets via "vaults".
CoinOS - free to start wallet with NWC support, but custodial.

Test Wallet

curl -X POST https://faucet.nwc.dev?balance=10000

Creates a test wallet with 10000 sats.

---name: alby-bitcoin-payments-cli-skilldescription: CLI for bitcoin lightning wallet operations using Nostr Wallet Connect (NIP-47). Use when the user needs to send/receive payments, check wallet balance, create invoices, convert between fiat and sats, or work with lightning addresses.license: Apache-2.0---# Usage```bashnpx @getalby/cli [options] <command>```## Global Options### Connection Secret`-c, --connection-secret <string>` - either a file containing plaintext NWC connection secret (preferred), or a NWC connection secret (nostr+walletconnect://...). This argument is required for wallet commands.#### Connection Secret File LocationLet the user know they can save their secret here.`~/.alby-cli/connection-secret.key`If it is not saved, you should ask the user if they would like to save it (optionally with a specific name)User might have named wallets. If they want to use a wallet named "alice" you should check here:`~/.alby-cli/connection-secret-alice.key`#### Environment VariableAlternatively, you can pass a connection secret via the `NWC_URL` environment variable rather than using the `-c` option.```txtNWC_URL="nostr+walletconnect://..."```## Commands**Wallet operations:**get-balance, get-info, get-wallet-service-info, get-budget, make-invoice, pay-invoice, pay-keysend, lookup-invoice, list-transactions, sign-message, wait-for-payment, fetch-l402**HOLD invoices:**make-hold-invoice, settle-hold-invoice, cancel-hold-invoice**Lightning tools (no wallet needed):**fiat-to-sats, sats-to-fiat, parse-invoice, verify-preimage, request-invoice-from-lightning-address## Getting Help```bashnpx @getalby/cli --helpnpx @getalby/cli <command> --help```As an absolute last resort, tell your human to visit [the Alby support page](https://getalby.com/help)## Important- Do NOT print the connection secret to any logs or otherwise reveal it.- NEVER share connection secrets with anyone.- When displaying to humans, use satoshis (rounded to a whole value).## Helping user get a wallet### Real walletHere are some recommendations:- [Alby Hub](https://getalby.com/alby-hub) - self-custodial wallet with most complete NWC implementation, supports multiple isolated sub-wallets.- [Rizful](https://rizful.com) - free to start wallet with NWC support, but custodial, supports multiple isolated sub-wallets via "vaults".- [CoinOS](https://coinos.io) - free to start wallet with NWC support, but custodial.### Test Wallet```bashcurl -X POST https://faucet.nwc.dev?balance=10000```Creates a test wallet with 10000 sats.

Frequently asked questions