feat: atomic swap support, simpler pay/receive commands

[rolznz]

updates alby cli to v0.8.0

removes some unnecessary documentation (already in --help on the CLI)

Dependent on getAlby/cli#45 and getAlby/cli#46

TODO:

• Alby CLI release

Summary by CodeRabbit

• Documentation
  • Updated CLI command examples to version 0.8.0 with improved instructions for wallet operations.
  • Clarified maximum spend amount guidance and retry options for payment errors.
  • Revised Bitcoin units guidance to use "sats" phrasing for consistency.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7553d24c-7f3c-4e02-9a23-eeab212dce1a

📥 Commits

Reviewing files that changed from the base of the PR and between 8856841 and a41e8a3.

📒 Files selected for processing (1)

• SKILL.md

---

📝 Walkthrough

Walkthrough

SKILL.md documentation was updated to version 1.3.0 with all @getalby/cli command examples bumped from 0.6.1 to 0.8.0. HTTP 402 guidance, Bitcoin/Fiat units phrasing, and error-handling text were revised accordingly.

Changes

Documentation Version and Guidance Sync

Layer / File(s)	Summary
Skill version metadata and CLI command examples SKILL.md	Skill version frontmatter updated to 1.3.0. CLI command examples for usage, named-wallet setup, getting help, and wallet auth/connect updated from @getalby/cli@0.6.1 to @getalby/cli@0.8.0.
Commands reference and HTTP 402 payment guidance SKILL.md	Commands section revised to instruct running npx -y @getalby/cli@0.8.0 <command> --help for exact arguments. HTTP 402 guidance updated to reference "maximum spend amount" cap on fetch. Common Issues 402 row updated to mention retry and adjusting maximum spend amount.
Discover–Fetch flow and units documentation SKILL.md	Discover → Fetch flow fetch command example updated to @getalby/cli@0.8.0. Bitcoin Units guidance revised to use "sats" phrasing with rounding to whole values. Fiat Units guidance retained alongside sats guidance.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

• getAlby/payments-skill#11: Both update SKILL.md HTTP 402 guidance and fetch command documentation.
• getAlby/payments-skill#12: Both revise SKILL.md HTTP 402 handling and maximum spend/amount limit guidance for fetch failures.
• getAlby/payments-skill#14: Both bump @getalby/cli command examples from 0.6.1 to 0.8.0 with adjusted fetch and max-spend guidance.

Suggested reviewers

• reneaaron

Poem

🐰 Version hops from one to three,
Commands upgraded, fresh and free!
Sats now ring where coin once stood,
Payment guidance understood. ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Title check	⚠️ Warning	The title claims 'atomic swap support' and 'simpler pay/receive commands', but the changeset only updates SKILL.md documentation to version 0.8.0 without introducing atomic swap functionality or command simplification.	Align the title with the actual changes, such as: 'docs: update Alby CLI to v0.8.0 and remove unnecessary documentation' to accurately reflect the documentation-only nature of this PR.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/v1.3.0

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}