With 2 Lightning nodes connected, Clams shows a modest capital gain. I connect the xpub for an on-chain wallet and the River exchange data - It's now a capital loss.
At the start of the demo, sats moving between our wallets appear to be spends and receives. Without the full picture, there's no way to know they're transfers.
Adding the on-chain wallet and the River CSV lets Clams track the bitcoin end to end:
River Exchange → on-chain wallet → lightning nodes.
Disposals get recategorized as transfers. In other words, they are no longer taxable events. The average cost basis went up too. River has the actual purchase prices, not inferred ones from on-chain timestamps.
Higher cost basis + transfers reclassified = realized gains flip from positive to negative.
"But I don't want to hand over my xpub to get a more accurate cost basis."
You don't. Your data never leaves your machine. You can connect your own Electrum, Esplora or Bitcoin RPC server for on-chain lookups.
More connections in Clams doesn't mean more trust. It means fewer false taxable events and an accurate cost basis.
Clams
clams@clams.tech
npub136hk...th6q
Purpose Built Bitcoin Accounting
Our YouTube channel has a new Getting Started playlist to walk you from installation to advanced workflows.
More videos coming. If there's a specific workflow you want covered, let us know.
https://www.youtube.com/playlist?list=PLkPrqEMuJt52fyIqotBkCHnLeeLHit35s


Super cool to see @nunchuk_io ship a CLI for agent wallets. We paired it with Clams.
The agent spends bitcoin within policy limits, exports the wallet descriptor, feeds it to Clams, and pulls a balance sheet.
Accounting for every millisat on a Lightning node is hard. Multiple nodes with different implementations and tens of thousands of transactions? Even harder.
Hook your Core Lightning & LND nodes up to Clams, pair with your favorite agent, and simply talk to your books.
Install Clams and onboard in 2 minutes with Claude Desktop
One command to install Clams + Agent Skills.
Open Claude to sign in. Then set your currency, cost basis method, and onchain source.
Done.
Private AI meets Bitcoin accounting.
@Maple AI + opencode Clams CLI.
Ask questions about your books without exposing your data.
Maple AI encrypts your data before it leaves your device and processes it in secure hardware that even they can't see into. No training on your data, no third-party sharing.
Opencode connects to Maple and talks to Clams CLI. Your books stay private.
We tried all the models on Maple and Kimi K2.5 was our favorite. It is fast and makes few errors, especially when paired with the Clams agent skills -
We'll put a setup guide together for anyone interested. In the meantime, you can download Maple and opencode using these links:
https://trymaple.ai/downloads

GitHub
GitHub - clams-tech/skills: Agent Skills for Clams CLI
Agent Skills for Clams CLI. Contribute to clams-tech/skills development by creating an account on GitHub.

OpenCode | The open source AI coding agent
OpenCode - The open source coding agent.
Complex bitcoin accounting workflows are easier when your agent knows Clams.
What you're watching is Claude Code using Clams CLI. The agent finds transactions nested among onchain and Lightning node journal entries. It connects wallets, imports CSVs, and generates branded reports. All from natural language prompts.
We've been building agent skills to improve how AI agents work with Clams. Every command, every workflow, every edge case.
learn more: 
GitHub
GitHub - clams-tech/skills: Agent Skills for Clams CLI
Agent Skills for Clams CLI. Contribute to clams-tech/skills development by creating an account on GitHub.
Clams v1.0.0-beta.8 is out.
@River is now a first-class connection. Import your Account Activity CSV directly.
New: manual cost basis overrides. Sometimes your imported data doesn't reflect the real cost basis. Incomplete purchase records, missing wallets. Now you can set it directly and see it reflected in your capital gains reports.
Our Custom connection feature has been improved to make it more flexible. Better support for exchanges with unusual CSV layouts. More edge cases covered, fewer workarounds. More details in the release notes.
Also in this release: better CLI error messages, offline auth validation, smarter on-chain transfer matching for custodial imports, and unique workspace label enforcement.
Full release notes:
Cheers,
Clams Team
Clams
River CSV Import & Cost Basis Overrides | v1.0.0-beta.8
River exchange CSV imports, manual cost basis overrides, improved CSV mapping DSL, and better error reporting.
Wallet to report in under a minute. Here's a quick look at the Clams CLI.
Connect a wallet, sync transactions, generate journal entries, and print reports. All from your terminal.
Lightning volume crossed an estimated $1B/month in 2025 (see latest @River report). More exchanges and mining pools are running nodes.
We put together some thoughts on why Lightning accounting is its own discipline.

Clams
Lightning Network Accounting: Channels, Fees & Force Closes
Channel opens, routing fees, and force closes each create accounting events. Clams captures every one and generates the journal entries your accoun...
We've had a few people reach out asking how to import transactions from wallets and exchanges that Clams doesn't natively support.
Clams has a "Custom" connection type built exactly for this. You can import any CSV and map the columns to match what Clams expects.
The easiest path: use an LLM to help you create a reusable mapping so future imports are one click.
We put together a step-by-step guide to walk you through it:
As always, keep the feedback coming,
Cheers.
Clams
Custom Connections Guide | Import Any CSV Into Clams
Step-by-step guide to import any exchange or wallet CSV into Clams using the Custom connection. Learn how to create CSV mappings that transform you...
We just shipped the Clams REST API.
Here's a full walkthrough covering auth, wallet connections, syncing, journal processing, annotations, and reports:
Our API docs are machine-readable by design. Point Claude Code, Codex or Open Code at the OpenAPI specs and let it build.
Some ideas:
→ Portfolio dashboards and BI integrations
→ Automated capital gains and tax reporting
→ Multi-client accounting from a single instance
→ Custom workflows on top of your own Bitcoin books
Get started:
Try it out, break things, and reach out via the built-in feedback endpoint.
Or shoot us an email to support@clams.tech
Happy building!
Clams
Clams REST API Guide | For Developers & Coding Agents
Developer and coding agent guide to the Clams Server REST API. Bitcoin accounting with auth, wallet connections, syncing, and reports.
Clams
Bitcoin Accounting API & Server | Self-Hosted REST API
Self-host a Bitcoin accounting server with a full REST API. Multi-user access, role-based permissions, and programmatic control over cost basis, re...
We just shipped the Clams REST API.
Here's a full walkthrough covering auth, wallet connections, syncing, journal processing, annotations, and reports:
Our API docs are machine-readable by design. Point Claude Code, Codex or Open Code at the OpenAPI specs and let it build.
Some ideas:
→ Portfolio dashboards and BI integrations
→ Automated capital gains and tax reporting
→ Multi-client accounting from a single instance
→ Custom workflows on top of your own Bitcoin books
Get started:
Try it out, break things, and reach out via the built-in feedback endpoint.
Or shoot us an email to support@clams.tech
Happy building!
Clams
Clams REST API Guide | For Developers & Coding Agents
Developer and coding agent guide to the Clams Server REST API. Bitcoin accounting with auth, wallet connections, syncing, and reports.
Clams
Bitcoin Accounting API & Server | Self-Hosted REST API
Self-host a Bitcoin accounting server with a full REST API. Multi-user access, role-based permissions, and programmatic control over cost basis, re...
Clams V1 Beta is live 🚀
Bitcoin accounting infrastructure you can deploy, integrate, and build on. Run it locally. Deploy it anywhere.
Our core logic has been entirely rewritten in Rust. Huge performance gains, especially for high-volume Lightning nodes. One install, then choose your interface: CLI or Server.
Bring your own node: Electrum, Esplora, or Bitcoin RPC. Full Tor support. Then connect and sync: on-chain wallets (xpub and descriptor support), Lightning nodes, addresses, custom CSV/JSON imports, and NWC wallets.
Generate capital gains reports, balance sheets, and portfolio summaries. Full audit records with canonical data: invoices, payments, trades, UTXOs, etc. Exchange rates in 19 fiat currencies. Smart tagging you refine over time.
Enterprise-ready from day one. Workspaces and profiles. Role-based access control. Audit trail. Multi-user management. Whether you're a solo operator or an accounting firm, Clams scales with you.
Clams CLI: your Bitcoin books, automated. Full accounting from your terminal. Automate reconciliation, reporting, and exports. Pipe output to other tools. Schedule jobs with cron. Hand control to Claude Code, Codex, or Open Code.
Clams Server: self-host your Bitcoin books anywhere. Expose REST API and CLI access to your team. Connect multiple clients to a single instance. Full role-based access control. Or skip the ops and use Clams Cloud as your hosted backend.
Built for Bitcoin businesses, miners, exchanges, Lightning service providers, accounting firms, and developers.
Learn more:
Get started:
Cheers,
Clams Team
Clams
Bitcoin Accounting Infrastructure | Clams V1 Beta
Clams rebuilt from the ground up in Rust. One binary, two interfaces: CLI and Server. Run locally or deploy your own server. Bitcoin accounting inf...
Clams
Get Started | Clams
Set up Clams in about 10 minutes. A step-by-step guide to installing Clams with Claude Code for automated Bitcoin accounting.
Very cool resource here from @TFTC
Honored to be included among a bunch of great Bitcoin products.
Check it out!
Cheers @MartyBent !

Bitcoin Products
Bitcoin Products - Trusted Bitcoin Tools, Wallets & Services
Discover battle-tested Bitcoin products we'd recommend to friends and family. Find trusted exchanges, hardware wallets, Lightning apps, and more.
New guide: How to import your Phoenix Wallet transactions into Clams for accurate cost basis tracking.
Covers Lightning + on-chain, and includes an AI prompt to automate the CSV conversion.
If you're using Phoenix and need proper accounting reports, this will save you hours.

Clams
Phoenix Wallet CSV Import for Bitcoin Taxes
Import your Phoenix Wallet transactions to track Lightning and on-chain cost basis. Generate tax reports in minutes.
After a year of building, with 2,500+ people now using Clams Desktop, we're ready to share what we're working on.
We started with Desktop. Now we're building the Bitcoin accounting layer.
Let's explain 🧵