A full-featured, non-custodial Bitcoin Cash wallet for your terminal. Send and receive BCH, manage CashTokens and NFTs, swap on Cauldron, chat over Nostr, interact with smart contracts, automate workflows, and let AI agents transact through MCP and x402.
The same core wallet logic as the Paytaca mobile app, exposed as composable commands. Pipe them, script them, or hand them to an agent.
Create or import a wallet, derive HD addresses, inspect balances and export your phrase behind biometrics — no browser, no extension.
BCH, satoshis, or USD — converted at the live rate before it leaves your wallet.
List, price, and send fungible tokens or individual NFTs — with token-aware z-prefix addresses.
Buy and sell tokens against BCH liquidity directly from the shell.
Encrypted conversations with keys derived from the same wallet. Nothing extra to store.
Every read command returns clean --json. Wire Paytaca into cron jobs, bots, and CI — or straight into an autonomous agent.
{
"paymentRequired": true,
"acceptsBch": true,
"estimatedCostSats": "100"
}The same wallet logic that powers the Paytaca app — rebuilt as composable commands your scripts and agents can trust.
Generate, import, and inspect a wallet. Secrets never leave the OS keychain.
mainnet by default · append --chipnet for testnet
x402 turns HTTP 402 Payment Required into a real payment flow. Paytaca CLI reads the quote, signs a Bitcoin Cash transaction locally, retries the request, and hands the response back — per call, no accounts, no cards.
Agent calls a paid API
GET /v1/completeServer returns a price
100 satsCLI signs & broadcasts locally
paytaca payRetried with proof, response in hand
{"text":"…"}{
"acceptsX402": true,
"acceptsBch": true,
"estimatedCostSats": "100"
}Preview the exact cost before a single sat moves.
--max-amount caps what any automated call can spend.
Payment is signed on your machine from the OS keychain.
One API call, one BCH transaction. No subscriptions.
paytaca-cli runs a local MCP server, so any MCP-compatible agent — Claude, Codex, OpenCode, Cursor, Pi — can read balances, watch history, and call Paytaca AI. Spending is bounded by two independent layers: the wallet you create, and a vault that enforces its rules on-chain.
harnessopencode·claude·cursor·codex·pi·generic
Choose full or read-only at wallet creation. Read-only holds just your xPub, so the agent can look but never sign — every send waits for your approval in the Paytaca app.
Spending is capped by a CashScript smart contract on Bitcoin Cash — not runtime rules the agent can ignore. Per-request, daily, and session limits are enforced on-chain, so it can pay within them and nowhere else.
paytaca_ai_*Inside those bounds the agent calls Paytaca AI — chat, image, video, and speech — paid from the vault, never your main wallet.
The mnemonic is written straight to the OS secret store — there is no plaintext wallet file to leak.
Revealing the recovery phrase requires an interactive terminal plus Touch ID, fingerprint, or Windows Hello.
HD derivation and transaction signing happen on-device. Only signed, well-formed data is broadcast.
Native access runs on prebuilt Rust binaries via @napi-rs/keyring — no node-gyp, no compile step.
One command to install. Node.js 20 or newer. macOS, Linux, and Windows, with your secrets kept in the system keychain.
git clone https://github.com/paytaca/paytaca-cli.git cd paytaca-cli && npm install npm run build && npm link