Everything the LucaKeep bot can do — with examples, accepted formats, and what you get back.
photo / PDF / fileUpload a document — starts the AI extraction flow/add income 500 descManually record an income transaction/add expense 45.50 descManually record an expense transaction/summary [month]Total income vs expenses for a month/stats [month]Side-by-side comparison vs the prior month/category [month]Spending ranked by category/insightsSpending by day of week, vendor, and time of day/recentYour last 5 confirmed transactions/exportDownload the full ledger as CSV (3 credits)/orgView active company or switch between organisations/balanceCheck how many credits you have left/topupBuy more credits/helpShow the command list in chatThe core flow. No command needed — just send the file.
LucaKeep reads it, extracts all transactions, and asks you to confirm each one.
Photos
Documents
Via Telegram
# 1. You send a receipt photo
# 2. Luca replies:
→ Found 1 transaction
→ Office Supplies — $124.00 · expense · Stationery
→ [✅ Confirm] [✏️ Edit] [❌ Discard]
No receipt? Add income or expenses directly from the keyboard. Free — no credits charged.
/add <income|expense> <amount> [description]Creates a confirmed transaction immediately. No AI processing, no credit charge.
type
income or expenseamount
Positive number, e.g. 1500 or 45.50
description
Optional. Anything after the amount. Defaults to Manual income/expense entry.
/add income 1500 Client payment — Acme Corp
/add expense 45.50 Coffee and snacks
/add income 200
→ 💰 Added income
→ 📝 Client payment — Acme Corp
→ 💵 $1,500.00 📅 2026-05-04 🏢 My Business
Category defaults to Income for income and General for expenses. Date is always today. Use the reply keyboard buttons 💰 Add income / 🧾 Add expense for a guided prompt.
All report commands work on your active organisation. Switch with /org if needed.
/summary [month]Shows total income, total expenses, and net for the selected month. Defaults to the current month.
/summary
/summary 2025-08
/summary Aug 2025
→ 📊 Summary — My Business
→ May 2026
→ Income: $3,200.00 ▲
→ Expenses: $1,850.00 ▼
→ ────────────────────
→ Net: +$1,350.00 ✅
If no transactions exist for the selected month, falls back to all-time totals.
/stats [month]Side-by-side table of this month vs the previous month, with percentage change for income, expenses, and net.
/stats
/stats 2025-08
→ 📊 Stats — My Business
→ May 2026 Apr 2026
→ Income $3,200.00 $2,800.00 ▲ 14%
→ Expenses $1,850.00 $2,100.00 ▼ 12%
→ ──────────────────────────────────────
→ Net $1,350.00 $700.00 ▲ 93%
/category [month]Lists your top 8 spending categories ranked by expense total, with income and count per category.
/category
/category 2025-08
→ 📂 Categories — My Business — May 2026
→ 1. Travel — out $640.00 (4 txn)
→ 2. Food & Dining — out $310.50 (12 txn)
→ 3. Software — out $249.00 / in $0.00 (3 txn)
→ ...
/insightsAnalyses your last 500 expenses to show which day of the week you spend most, your top vendors, and time-of-day breakdown (if receipts include a time).
/insights
→ 📈 Spending Profile — My Business
→ Based on 87 confirmed expenses
→
→ Spending by day of week:
→ Mon ██████░░░░ $820.00 (14)
→ Fri ████████░░ $1,140.00 (18)
→ ...
→
→ Top vendors:
→ 1. Uber — $340.00 (9x)
→ 2. Slack — $120.00 (3x)
No month argument — always uses all confirmed expense transactions for your organisation.
/recentShows your 5 most recent confirmed transactions — description, amount, type, and date.
/recent
→ 📋 Last 5 transactions — My Business
→ 1. 💰 Client payment — $1,500.00 income — 2026-05-04
→ 2. 🧾 Uber ride — $24.50 expense — 2026-05-03
→ 3. 🧾 AWS — $89.00 expense — 2026-05-01
/exportSends a CSV file of all confirmed transactions for your active organisation. Costs 3 credits.
/export
→ 📎 my-business-2026-05-04.csv
→ 142 transactions · 3 credits used
/orgShows which company is currently active. If you have multiple organisations, presents buttons to switch between them.
/org
→ 🏢 Active: My Business
→ [Switch to Acme Ltd] [Switch to Side Project]
All upload and report commands operate on the active organisation. Switch before uploading if needed.
/balanceShows how many credits you have remaining and a brief breakdown of recent usage.
/balance
→ 💳 Credit balance: 47 credits remaining
→ Used this month: 12 · All time: 38
/topupStarts the credit top-up flow with a link to the checkout page.
/topup
→ 💳 Credit Top-up
→ Choose a pack to continue:
→ [50 credits — $5] [200 credits — $15]
After the bot shows an extracted transaction, tap ✏️ Edit to correct any field before confirming.
When in edit mode, type field value to update any field. Type cancel to go back without changing.
amountPositive number
amount 124.50type"income" or "expense"
type incomedateYYYY-MM-DD format
date 2026-04-30categoryAny text
category TravelvendorAny text
vendor Acme CorpdescriptionAny text
description Q1 retainer# After tapping ✏️ Edit:
amount 250
→ ✅ Updated amount to 250
category Consulting
→ ✅ Updated category to Consulting
→ [✅ Confirm] [✏️ Edit another] [❌ Discard]
/summary, /stats, and /category all accept an optional month argument.
(no argument)Current month
/summaryYYYY-MMSpecific month
/summary 2025-08Mon YYYYSpecific month
/summary Aug 2025Month YYYYSpecific month
/summary August 2025If no transactions exist for the requested month, the bot shows all-time totals with a note.
A button bar appears above the text input — no need to type commands for common actions.
Runs /summary for the current month
Runs /recent — last 5 transactions
Runs /balance — shows remaining credits
Shows the command list in chat
Prompts you with the /add income format and examples
Prompts you with the /add expense format and examples
The button bar appears automatically after /start, /help, and /add. It persists in your Telegram session until dismissed.