Command catalog
Search is off for now, so this page lists every available command, its parameters, and a concrete example. All commands work in private 1:1 chats with the bot.
Jump to
- Onboarding & help
- Quick capture & receipts
- Transactions
- Wallets & balances
- Credit tools
- Debts & repayments
- History & reports
Onboarding & help
| Command | Parameters | What it does | Example |
|---|---|---|---|
/start | none | Sends the welcome message and checks bot permissions. | /start |
/help [topic] | topic options: wallet, add, recent, report, search, debts | Shows inline help for a topic; plain /help shows buttons for all topics. | /help wallet |
/categories list | none | Shows your current category labels. | /categories list |
/categories set LABEL,LABEL | labels comma-separated | Replaces your labels with a custom list. | /categories set Dining Out,Groceries |
/categories reset | none | Restores the default labels. | /categories reset |
Quick capture & receipts
| Command / Shortcut | Parameters | What it does | Example |
|---|---|---|---|
| Free text shorthand | TYPE one of e/i/d/r, AMOUNT, DESCRIPTION, optional @wallet prefix | Fast entry for expense/income/debt/receivable without typing /add. Returns a detailed view with edit/delete buttons. | @travel e taxi 75000 airport |
/add [@wallet] TYPE AMOUNT DESCRIPTION [DATE] | type = expense, income, debt, or receivable; optional date (YYYY-MM-DD) or date=... | Creates a transaction with the given type, description, and optional date. | /add @cash expense 125000 groceries 2024-01-01 |
| Receipt photo | Send a photo with optional caption tokens: @wallet, installments=<n>, beneficiary=Name | Parses a receipt, saves the transaction, and updates the status message to show full details/buttons. | Send photo with caption @cash installments=6 beneficiary=Travel |
Amounts accept commas, decimals, and shorthands:
kfor thousands (e.g.50k= 50,000) andjtfor millions (e.g.1.5jt= 1,500,000). The bot normalises formatting automatically.
Transactions
| Command | Parameters | What it does | Example |
|---|---|---|---|
/t <number> | number = index from /recent list | Shows full detail for a transaction. | /t 1 |
/edit [number] [updates] | Optional number (index); updates in field=value format | Quickly edits the last added transaction or a specific index. | /edit amount=55000 or /edit 1 category=Food |
Wallets & balances
All wallet subcommands also work with the alias /wallets.
| Command | Parameters | What it does | Example |
|---|---|---|---|
/wallet or /wallet list | none | Lists all wallets with balances. Tap a wallet to see details and actions. | /wallet |
| `/wallet add NAME TYPE [currency=IDR] [limit=AMOUNT] [settlement=DAY] [kind=cc|paylater] [default=yes | no]` | TYPE = regular, investment, or credit; kind only for credit wallets (cc = monthly statement, paylater = BNPL-style); limit and settlement apply to credit wallets. | /wallet add Travel credit currency=IDR limit=25000000 settlement=25 kind=cc |
| `/wallet edit NAME [name=...] [currency=...] [limit=...] [settlement=DAY] [kind=cc|paylater] [default=yes | no]` | Updates the specified fields for a wallet. | /wallet edit Travel settlement=20 limit=30000000 |
/wallet default NAME | name | Sets the default wallet for future entries. | /wallet default Main Wallet |
/wallet transfer AMOUNT FROM TO [note=...] | amount numeric; from/to are wallet names or @wallet hints | Moves funds between wallets and records matching transactions. | /wallet transfer 200000 @cash @travel note=top-up |
/wallet adjust WALLET TARGET_BALANCE [desc=...] [date=YYYY-MM-DD] | target_balance is the desired ending balance | Records an adjustment transaction to reach the target balance. | /wallet adjust @cash 2500 desc=Manual adjustment date=2025-11-01 |
/wallet delete NAME confirm=yes | confirm=yes required; cannot delete the default wallet | Deletes a wallet; transactions remain but lose the wallet link. | /wallet delete OldWallet confirm=yes |
/wallet investment roe WALLET [start=YYYY-MM-DD] [end=YYYY-MM-DD] | wallet must be an investment wallet; optional date range | Calculates simple return on equity for an investment wallet. | /wallet investment roe @invest start=2024-01-01 end=2024-12-31 |
Wallet Sharing
| Command | Parameters | What it does | Example |
|---|---|---|---|
/wallet share invite WALLET @username [view|write] | @username is the Telegram username of the person to invite; access defaults to view | Invites another user to collaborate on your wallet. They receive a notification to accept. | /wallet share invite Travel @john_doe write |
/wallet share list WALLET | none | Lists all collaborators on the wallet. | /wallet share list Travel |
/wallet share accept SHARE_ID | share_id from invitation notification | Accepts an invitation to collaborate on someone's wallet. | /wallet share accept abc123 |
💡 Tip: Invitees receive an automatic notification with Accept/Decline buttons. If they haven't started the bot yet, they'll be auto-registered when you invite them.
Credit tools
| Command | Parameters | What it does | Example |
|---|---|---|---|
/wallet credit purchase WALLET AMOUNT [installments=3] [beneficiary=Name] [desc=...] | wallet must be credit; installments splits the purchase; beneficiary tags who it was for | Records a credit card/paylater purchase and creates an installment schedule. | /wallet credit purchase @card 250000 installments=6 beneficiary=Travel desc=Flight |
/wallet credit repay WALLET AMOUNT [from=@wallet] [beneficiary=Name] [desc=...] | wallet credit wallet being repaid; optional from source wallet | Applies a repayment and can pull cash from another wallet. | /wallet credit repay @card 500000 from=@cash desc=Bill payment |
/wallet credit statement WALLET [reference=YYYY-MM-DD] | reference date overrides "today" for the statement window | Shows the upcoming settlement amount and due installments. | /wallet credit statement @card reference=2025-12-02 |
/lendcredit CREDIT_WALLET NAME AMOUNT [installments=3] [desc=...] [note=...] [track=yes] | Combines a credit purchase and a debt; name is who owes you; track=yes also creates a receivable transaction | Creates the card purchase and debt; optionally tracks as receivable transaction. | /lendcredit @card IntegrationFriend 40k installments=3 track=yes |
Debts & repayments
| Command | Parameters | What it does | Example |
|---|---|---|---|
/lend NAME AMOUNT [note] [track=yes] | name = who owes you; amount supports k/jt shorthands; track=yes creates a receivable transaction | Creates a debt record; optionally tracks as receivable transaction. | /lend Alice 50k track=yes |
/repay NAME AMOUNT [note] [all] [track=yes] | Applies a payment to outstanding debt; add all to pay everything; track=yes creates income transaction | Updates debt; optionally tracks as income transaction. | /repay Alice 50000 track=yes |
/owed [name] | Optional name filter | Shows a compact summary (date · amount · name) with buttons to drill into each debtor's details. | /owed Alice |
History & reports
| Command | Parameters | What it does | Example |
|---|---|---|---|
/recent [@wallet] [category] [limit=TOTAL] [per=PAGE] [date_filter] | category can be positional; date_filter supports since, until, on, or YYYY-MM-DD..YYYY-MM-DD | Lists transactions with flexible date filtering and pagination. | /recent @cash 2024-12-01..2024-12-31 per=5 |
/search QUERY [@wallet] [limit=N] [since=YYYY-MM-DD] [until=YYYY-MM-DD] | query = search text; optional wallet and date filters | Searches transactions by description or category (case-insensitive). | /search pizza or /search @cash groceries |
/report RANGE [debts] [since=YYYY-MM-DD] [until=YYYY-MM-DD] | range options: today, yesterday, mtd, ytd, last 7 days, last 3 months, last year; add debts to show lend/repay summary; since= sets start date (defaults end to today), until= sets end date | Summarises income/expense by default; add debts to show receivable/debt transactions instead. | /report mtd or /report since=2025-01-01 or /report debts ytd |