Kittyledger iconKittyledger

Documentation

Bot Commands

Everything you need to know about using Kittyledger AI

Type /help in the bot anytime

Quick Start

Get started in 30 seconds

1

Open the bot

Search @kittyledger_bot in Telegram

2

Send a receipt

Take a photo and send it to the chat

3

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

/start

Start the bot and see the welcome message. Shows your current credit balance and registers your username.

/help

Display all available commands, pricing information, and quick start guide.

/info/about

Learn 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/bal

View comprehensive balance summary including total outflows, inflows, net balance, and receipt counts. Supports multi-currency display.

/transactions/txn

Ledger-style view showing all transactions with running balance. Sorted chronologically with pagination support.

/txn 2
/inflows

View only deposits and income. Shows total inflows with pagination.

/inflows
/outflows

View 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
/summary

Monthly 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/dup

Scan 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 10000

Data Export

Export your data for accounting and analysis

/export

Export 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/dashboard

Open 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
/insights

Get AI-generated spending analysis based on your receipt history. Costs 1 credit. Requires at least 5 receipts to generate meaningful insights.

Credits

Check your balance. Email hello@kittyledger.ai to replenish.

/credits

View your current credit balance and total usage stats.

Receipt Editing

Fix mistakes in recorded receipts (no / prefix needed)

update [id] [field] [value]correctfix

Update 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 today
delete [id]remove

Permanently delete a receipt from your records. This updates your balance accordingly.

delete ABCDEF

Advanced

Additional tools for power users

/scan

Scan chat for unprocessed receipt photos. Costs 1 credit per receipt processed.

/incomplete

Show receipts that are missing required information (date, amount, or merchant). Helps you find entries that need fixing.

/compact

Toggle 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?

Send a receipt photo to the bot. See what it does.

Paw iconOpen in Telegram

Type /start to begin