Documentation
Bot Commands
Everything you need to know about using Kittyledger AI
/help in the bot anytimeQuick Start
Get started in 30 seconds
Open the bot
Search @kittyledger_bot in Telegram
Send a receipt
Take a photo and send it to the chat
Get your data
AI extracts all details automatically
Understanding Two Balances
Receipt Balance /balance
Your actual petty cash money. Tracks outflows and inflows. This is what you owe or have available.
Credit Balance /credits
AI processing credits. 1 credit = 1 receipt scan or 1 AI insights query. Credits replenish monthly based on your plan.
Command Reference
All commands
Essential Commands
Basic commands to get started with Kittyledger
/startStart the bot and see the welcome message. Shows your current credit balance and registers your username.
/helpDisplay all available commands, pricing information, and quick start guide.
/info/aboutLearn how Kittyledger AI works, understand balance calculations, and discover team/group chat features.
Receipt & Balance Tracking
Track your expenses, view balances, and manage receipts
/balance/balView comprehensive balance summary including total outflows, inflows, net balance, and receipt counts. Supports multi-currency display.
/transactions/txnLedger-style view showing all transactions with running balance. Sorted chronologically with pagination support.
/txn 2/inflowsView only deposits and income. Shows total inflows with pagination.
/inflows/outflowsView only expenses. Shows total outflows with category breakdown and pagination.
/outflows/merchant [name]Filter receipts by merchant. Without a name, shows top merchants with counts. Supports partial matching and pagination.
/merchant Starbucks/category [name]Filter receipts by category. Without a name, shows all categories with counts. Supports partial matching and pagination.
/category Food/summaryMonthly spending summary with insights: total outflows, month-over-month comparison, top categories, and most frequent merchant. Multi-currency support.
/report [period]Generate spending report for a specific period. Supports: /report (current month), /report week (last 7 days), /report 2026-01 (specific month), /report january (month name).
/report week/receipts [page]Browse all your receipts with pagination. Shows 10 receipts per page, sorted by date (newest first). Navigate with /receipts 2, /receipts 3, etc.
/receipts 2/receipt [id]View a specific receipt with full details and the original image. Get receipt IDs from the /receipts command.
/receipt ABCDEF/duplicates/dupScan for duplicate receipts by detecting matching amounts and dates. Helps prevent double-counting.
/reconcile [amount]Compare actual cash on hand with book balance. Enter your physical cash count to check for discrepancies (overage or shortage).
/reconcile 4850/initial [amount]Set your starting petty cash balance. One-time command when setting up the bot.
/initial 10000Data Export
Export your data for accounting and analysis
/exportExport all receipts to a CSV spreadsheet. Ready for Excel, Google Sheets, or accounting software. Includes all tracked data.
Dashboard & Insights
Visualize spending patterns and get AI-powered analysis
/dash/dashboardOpen your interactive dashboard showing credit count, this month's receipt total, and inline action buttons for quick access to Balance, Report, Export, and Help.
/trend [mode]View spending trends over time. Modes: weekly (default, last 8 weeks) or monthly (last 12 months). Supports year filter (/trend monthly 2025) and month filter (/trend weekly jan).
/trend monthly 2026/insightsGet AI-generated spending analysis based on your receipt history. Costs 1 credit. Requires at least 5 receipts to generate meaningful insights.
Credits & Subscription
Manage your subscription and credit balance
/creditsView your current credit balance and total usage stats.
/plan/subscription/usageView your subscription tier, credit balance breakdown (subscription vs bonus credits), next credit reset date, and days until reset.
Receipt Editing
Fix mistakes in recorded receipts (no / prefix needed)
update [id] [field] [value]correctfixUpdate any field of an existing receipt. Available fields: amount, merchant, date, category, tax, notes, type, currency. Supports multi-line: send multiple fix commands in one message. Date shortcuts: 'today', 'yesterday'.
fix ABCDEF date todaydelete [id]removePermanently delete a receipt from your records. This updates your balance accordingly.
delete ABCDEFAdvanced
Additional tools for power users
/scanScan chat for unprocessed receipt photos. Costs 1 credit per receipt processed.
/incompleteShow receipts that are missing required information (date, amount, or merchant). Helps you find entries that need fixing.
/compactToggle compact mode for shorter, single-line responses. Reduces chat clutter while keeping essential info.
/feedback [message]Send feedback, suggestions, or bug reports directly to the developer. Maximum 1000 characters.
/feedback Love the bot! Would be great to have bulk upload.Pro Tips
Get the most out of Kittyledger
No Receipt? No Problem
Write expenses on paper and snap a photo. Our AI reads handwritten notes just like printed receipts. Perfect for cash payments or tips.
Use in Group Chats
Add the bot to a Telegram group and all members can upload receipts to a shared ledger. Perfect for teams.
Blurry Photos Work
Our AI handles blurry photos, crumpled receipts, and low-quality images. Just snap and send.
Get AI Insights
Use /insights after tracking 5+ receipts to get AI-powered spending analysis and personalized recommendations.
Check for Duplicates
Run /dup periodically to catch accidentally uploaded duplicate receipts before they mess up your balance.
Ready to try it out?
Start with 20 free credits every month. No credit card required.
Type /start to begin