Skip to main content
Logging visits is toni’s core feature. Track every restaurant experience with ratings, dates, notes, and whether you’d return.

Quick-Add from Visits Screen

The fastest way to log a visit is from the Visits screen:
1

Open the Visits screen

Press v from any screen or navigate using b/f tabs
2

Press 'a' to add a visit

This opens the visit form in insert mode
3

Fill in the form fields

Use tab and shift+tab to navigate between fields:
  • Restaurant (required): Search for a restaurant name
  • Visit Date (optional): Natural date format like “June 20, 2025”
  • Rating (optional): 1-10 scale, decimals allowed
  • Would Return? (optional): y or n
  • Notes: Add any details about your experience
4

Save with Ctrl+S

Press ctrl+s to save or esc to cancel

Add Visit from Restaurants Screen

You can also log a visit directly from the Restaurants screen:
1

Navigate to Restaurants

Press r from any screen or use b/f tabs
2

Select a restaurant

Use j/k to navigate to the restaurant
3

Press 'v' to log a visit

This opens the visit form with the restaurant pre-filled
4

Complete and save

Fill in the remaining fields and press ctrl+s
Logging a visit from the Restaurants screen pre-fills the restaurant name, saving you time!

Rating Scale

Ratings use a 1-10 scale with decimal support:
  • 1-3: Poor experience
  • 4-6: Average/acceptable
  • 7-8: Good experience
  • 9-10: Excellent/exceptional
Decimals are supported for precision (e.g., 7.5, 8.2).
Rating: 8.5
Ratings are optional. Leave blank if you prefer not to rate a particular visit.

Date Format

The Visit Date field accepts natural date formats:
  • Full format: June 20, 2025
  • Month abbreviation: Jun 20, 2025
  • ISO format: 2025-06-20
The date is stored internally as ISO 8601 format (YYYY-MM-DD) and displayed in human-readable formats throughout the app.
Leave the date field blank to use today’s date automatically.

Would Return Field

The Would Return field captures whether you’d visit the restaurant again:
  • y, yes, or 1 = Yes (displayed with ✓)
  • n, no, or 0 = No (displayed with ✗)
  • Leave blank if unsure or not applicable
This field appears with color coding:
  • Green ✓ for “yes”
  • Red ✗ for “no”

Adding Notes

The Notes field supports up to 500 characters:
Notes: Amazing carbonara! Generous portions. 
Service was friendly but slow. Would recommend 
the tiramisu.
Use notes to capture:
  • Specific dishes you tried
  • Service quality
  • Ambiance details
  • Who you dined with
  • Special occasions

Restaurant Autocomplete

When entering a restaurant name, toni uses Yelp integration for autocomplete:
1

Type at least 2 characters

Start typing the restaurant name in the Restaurant field
2

View search results

After 300ms, autocomplete suggestions appear in a dropdown or sidebar (on wide terminals)
3

Navigate results

  • j/k or /: Move through results
  • enter or tab: Select a suggestion
  • esc: Close the dropdown
4

Auto-save restaurant data

Selecting a suggestion automatically creates the restaurant with address, city, cuisine, and location data
If you type a restaurant name that doesn’t exist in your database, toni will create it automatically when you save the visit.

Editing Visits

To edit an existing visit:
  1. Navigate to the visit in the Visits screen (j/k)
  2. Press enter or l to open visit details
  3. Press e to edit
  4. Modify fields and save with ctrl+s
Edits are tracked with undo support. Press u to undo recent changes.

Form Keybindings

When in the visit form (insert mode):
KeyAction
tabNext field
shift+tabPrevious field
ctrl+sSave visit
escCancel and return
j/kNavigate autocomplete (when dropdown is open)
enterSelect autocomplete suggestion

FAQ

Yes! Each visit is tracked separately with its own date, rating, and notes. View all visits to a restaurant from the Restaurant detail screen.
The current date is used automatically when you save the visit.
Absolutely. All fields except the restaurant name are optional. Log as much or as little as you want.
Open the visit detail screen (enter from the Visits list), then press d to delete. You can undo with u if needed.

Build docs developers (and LLMs) love