Kittyledger iconKittyledger
Paw iconGet Started Free

20 free credits/month • No credit card required

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 & Subscription

Manage your subscription and credit balance

/credits

View your current credit balance and total usage stats.

/plan/subscription/usage

View 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]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?

Start with 20 free credits every month. No credit card required.

Paw iconOpen in Telegram

Type /start to begin