Clams now matches custodial wallet transfers automatically. And lets you manually link the ones it can't infer. We also improved our Lightning channel close accounting. Full release notes for v1.0.0-beta.12 -

Clams

Manual Transfer Links & Custodial Matching | v1.0.0-beta.12

Clams v1.0.0-beta.12: manual transfer links when automatic inference is unsafe, automatic custodial-to-custodial matching, a CSV mapping inspector,...

As always, to update just run: clams update

If you need a solid private AI stack for your Bitcoin books consider: Venice AI for natural-language inference. No prompt logging, no training on your data. Clams for the local accounting engine. Opencode as the agent shell. New guide -

Clams

Venice AI Bitcoin Accounting | Opencode Desktop & Clams Setup

Set up Venice AI with Opencode Desktop and Clams for private Bitcoin accounting. Generate an API key, connect a model, load the skill.

Need a guide for a different stack? Let us know.

We put together a comprehensive list of all Clams features on our site as we had some feedback. Some highlights: 1. Reconciles Lightning channels with on-chain activity 2. Auto-matches self-transfers, no double-counting 3. No caps on wallets, transactions, or reports 4. Drivable by scripts and agents via CLI 5. Runs fully local after sync View the full list here -

Clams

Features | Clams

Everything Clams supports. On-chain, Lightning, accounting, enterprise, and integrations. The comprehensive feature reference.

If you need to find your cost basis for the 1099-DA form, Clams will do this for you. Fully private, data never leaves your machine. No sharing addresses or xpub’s with anyone. No limits on wallets or transactions. We have guides on our YouTube channel and blog. And we are happy to help if you are stuck.

Clams v1.0.0-beta.10 is out. Historical balance sheets are now available. The report takes an as-of flag, so you can pick any point in the past and get the books as they stood that day. Useful for audits, year-end, board reports, and due diligence. Lightning sync reliability got better across the board. Core Lightning works more cleanly over Tor-backed Commando. Long syncs are much more stable. LND pending-invoice handling is more reliable for nodes carrying many open invoices. On-chain wallets are faster too, with quicker incremental syncs after the first scan and recovery from older checkpoint formats. Testnet4 is now supported across Address, Descriptor, and XPub connections. A new flag lets you force a full sync and rebuild from scratch when you need to. Run clams update. Full notes:

Clams

Historical Balance Sheets & Reliable Lightning Syncs | v1.0.0-beta.10

Historical balance sheets via --as-of, more reliable Core Lightning and LND syncs, testnet4 support, faster on-chain incrementals, and journal fixes.

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.

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

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

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.

We'll put a setup guide together for anyone interested. In the meantime, you can download Maple and opencode using these links:

Maple AI

Maple Research | Private AI Workspace

Open Maple Research to sign up or log in to your private AI workspace.

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:

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.

Cheers, Clams Team

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 Node Accounting Guide: Routing Fees & Taxes (2026)

Track Lightning node income, channel events, and routing fees for accurate tax reporting. A complete Bitcoin accounting guide for node operators.

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:

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

As always, keep the feedback coming, Cheers.

We just shipped the Clams REST API. Here's a full walkthrough covering auth, wallet connections, syncing, journal processing, annotations, and reports:

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.

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:

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

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!

We just shipped the Clams REST API. Here's a full walkthrough covering auth, wallet connections, syncing, journal processing, annotations, and reports:

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.

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:

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

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

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

Get started:

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.

Cheers, Clams Team

Very cool resource here from @TFTC Honored to be included among a bunch of great Bitcoin products. Check it out!

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.

Cheers @MartyBent !

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 Tax Guide: Lightning & On-Chain Cost Basis

Track your Phoenix Wallet transactions for Bitcoin taxes. Free guide covers Lightning + on-chain cost basis with step-by-step CSV import. Done in m...