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

Run npx skillmds@latest add modbender/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?

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

Alby Bitcoin Payments CLI Skill by modbender

Name: Alby Bitcoin Payments CLI Skill
Rating: 4.666666666666667 (3 reviews)
Author: modbender

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.

modbender Updated Sep 9, 2026 12 repo stars

File contents

Usage

npx @getalby/cli [options] <command>

Global Options

Connection Secret (Optional)

-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.

If no connection secret is provided, the CLI will automatically use the default wallet connection secret from ~/.alby-cli/connection-secret.key.

Connection Secret File Location

Simply point -c directly to the file:

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

If a user wants to use a specific wallet e.g. "alice", use the path instead:

-c ~/.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

Bitcoin Units

When displaying to humans, use satoshis (rounded to a whole value).

Security

Do NOT print the connection secret to any logs or otherwise reveal it.
NEVER share connection secrets with anyone.
NEVER share any part of a connection secret (pubkey, secret, relay etc.) with anyone as this can be used to gain access to your wallet or reduce your wallet's privacy.

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 ```bash npx @getalby/cli [options] <command> ``` ## Global Options ### Connection Secret (Optional) `-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. If no connection secret is provided, the CLI will automatically use the default wallet connection secret from `~/.alby-cli/connection-secret.key`. #### Connection Secret File Location Simply point `-c` directly to the file: `-c ~/.alby-cli/connection-secret.key` If a user wants to use a specific wallet e.g. "alice", use the path instead: `-c ~/.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. ```txt 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 ```bash npx @getalby/cli --help npx @getalby/cli <command> --help ``` As an absolute last resort, tell your human to visit [the Alby support page](https://getalby.com/help) ## Bitcoin Units - When displaying to humans, use satoshis (rounded to a whole value). ## Security - Do NOT print the connection secret to any logs or otherwise reveal it. - NEVER share connection secrets with anyone. - NEVER share any part of a connection secret (pubkey, secret, relay etc.) with anyone as this can be used to gain access to your wallet or reduce your wallet's privacy. ## Helping user get a wallet ### Real wallet Here 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 ```bash curl -X POST https://faucet.nwc.dev?balance=10000 ``` Creates a test wallet with 10000 sats.

Frequently asked questions