When to Use
User needs ANY help with taxis, rideshares, car services, or ground transportation. Agent handles research, comparison, booking assistance, price monitoring, expense tracking, and problem resolution.
Architecture
Memory lives in ~/taxi/. See memory-template.md for setup.
~/taxi/
├── memory.md # Preferences, saved addresses, default apps
├── trips.md # Trip history and expenses
├── accounts.md # Which apps user has, preferences per app
└── promos.md # Active promo codes, referral links
Quick Reference
| Topic |
File |
| Memory setup |
memory-template.md |
| City/app coverage |
cities.md |
| Fare estimation |
fares.md |
| Booking workflows |
booking.md |
| Problem resolution |
problems.md |
Core Rules
1. Know User Context First
Before any recommendation, check ~/taxi/memory.md for:
- Preferred apps and why
- Saved addresses (home, work, airport)
- Payment preferences (card, cash, business)
- Special needs (wheelchair, car seat, pet-friendly)
- Budget sensitivity
2. Proactive Comparison
| Task |
Agent Action |
| User needs ride |
Compare 3+ options with current prices |
| Surge detected |
Alert user, suggest waiting or alternatives |
| Airport transfer |
Compare rideshare vs shuttle vs taxi vs car service |
| Group ride |
Calculate if multiple rides or XL is cheaper |
| Regular route |
Track prices over time, suggest best booking window |
3. Maximize Savings
- Search for active promo codes before any booking
- Check if user has referral credits in any app
- Compare scheduled vs on-demand pricing
- Suggest pool/shared when time permits
- Monitor surge and alert when it drops
- Find airport flat rates vs metered options
4. Assist Booking Process
What agent CAN do:
- Open booking websites/apps via browser
- Pre-fill pickup and destination
- Select vehicle type based on user needs
- Apply promo codes
- Set scheduled pickup time
- Navigate to payment confirmation step
What requires user:
- Final payment confirmation
- Entering new payment methods
- Phone verification
5. Handle Special Scenarios
| Scenario |
Agent Handles |
| Airport pickup |
Check terminal, flight tracking for delays, meet & greet options |
| Business travel |
Ensure receipt capability, corporate profile, expense categories |
| Late night |
Prioritize safety features, well-rated drivers, tracked rides |
| Foreign country |
Find local apps, check cash/card acceptance, language tips |
| Large group |
Calculate split options, find vans/minibuses, coordinate multiple cars |
| Accessibility |
Filter for wheelchair-accessible, verify with company if needed |
| With pets |
Find pet-friendly options, carrier requirements |
| With kids |
Car seat availability, family-friendly services |
| VIP/Executive |
Car services, black car, chauffeur options |
| Event pickup |
Coordinate pickup points, surge avoidance strategies |
6. Track Everything
Log in ~/taxi/trips.md:
- Date, route, app used
- Price paid, promo applied
- Category (personal, business, specific project)
- Notes (late driver, surge, issues)
Provide:
- Monthly expense summaries
- Per-category totals
- Comparison vs public transit
- Year-over-year trends
7. Resolve Problems
When user has issue:
- Identify problem type (overcharge, route, driver, safety, lost item)
- Find correct channel (in-app, email, phone, social)
- Draft complaint with relevant details
- Track resolution status
- Escalate if no response (BBB, local regulator, social media)
See problems.md for dispute workflows by app.
8. Stay Current
- Check for new apps entering user's city
- Monitor promo code sources (RetailMeNot, Honey, app-specific)
- Track regulatory changes (some cities ban/restrict services)
- Know seasonal patterns (holiday surge, airport construction)
9. Multi-Modal Integration
Sometimes taxi isn't best option:
- Compare with public transit for cost/time
- Suggest train + last-mile rideshare
- Rental car for multi-day or multi-stop
- Hotel shuttle for airport
- Walking + rideshare vs door-to-door
10. Privacy & Security
- Never store full payment details
- Mask home address in logs if user prefers
- Share trip tracking with emergency contacts
- Verify driver details before user enters vehicle
Common Traps
- Booking without checking surge → Always show current multiplier
- Assuming one app works everywhere → Check local alternatives first
- Ignoring scheduled ride option → Often 10-20% cheaper
- Not logging business trips immediately → Harder to categorize later
- Using first promo code found → Some stack, some conflict, check terms
- Recommending cheapest without context → Safety/reliability matter for some trips
- Forgetting airport rules → Designated pickup areas, terminal-specific pricing
- Not tracking flight delays → User waits, ride leaves or charges wait time
- Ignoring user's past preferences → Check memory before suggesting
1---2name: taxi3description: Handle everything for ground transportation, from price comparison to booking, tracking, disputes, and expense management.4---5
6## When to Use
7
8User needs ANY help with taxis, rideshares, car services, or ground transportation. Agent handles research, comparison, booking assistance, price monitoring, expense tracking, and problem resolution.
9
10## Architecture
11
12Memory lives in `~/taxi/`. See `memory-template.md` for setup.
13
14```
15~/taxi/
16├── memory.md # Preferences, saved addresses, default apps
17├── trips.md # Trip history and expenses
18├── accounts.md # Which apps user has, preferences per app
19└── promos.md # Active promo codes, referral links
20```
21
22## Quick Reference
23
24| Topic | File |
25|-------|------|
26| Memory setup | `memory-template.md` |
27| City/app coverage | `cities.md` |
28| Fare estimation | `fares.md` |
29| Booking workflows | `booking.md` |
30| Problem resolution | `problems.md` |
31
32## Core Rules
33
34### 1. Know User Context First
35Before any recommendation, check `~/taxi/memory.md` for:
36- Preferred apps and why
37- Saved addresses (home, work, airport)
38- Payment preferences (card, cash, business)
39- Special needs (wheelchair, car seat, pet-friendly)
40- Budget sensitivity
41
42### 2. Proactive Comparison
43| Task | Agent Action |
44|------|--------------|
45| User needs ride | Compare 3+ options with current prices |
46| Surge detected | Alert user, suggest waiting or alternatives |
47| Airport transfer | Compare rideshare vs shuttle vs taxi vs car service |
48| Group ride | Calculate if multiple rides or XL is cheaper |
49| Regular route | Track prices over time, suggest best booking window |
50
51### 3. Maximize Savings
52- Search for active promo codes before any booking
53- Check if user has referral credits in any app
54- Compare scheduled vs on-demand pricing
55- Suggest pool/shared when time permits
56- Monitor surge and alert when it drops
57- Find airport flat rates vs metered options
58
59### 4. Assist Booking Process
60What agent CAN do:
61- Open booking websites/apps via browser
62- Pre-fill pickup and destination
63- Select vehicle type based on user needs
64- Apply promo codes
65- Set scheduled pickup time
66- Navigate to payment confirmation step
67
68What requires user:
69- Final payment confirmation
70- Entering new payment methods
71- Phone verification
72
73### 5. Handle Special Scenarios
74
75| Scenario | Agent Handles |
76|----------|---------------|
77| Airport pickup | Check terminal, flight tracking for delays, meet & greet options |
78| Business travel | Ensure receipt capability, corporate profile, expense categories |
79| Late night | Prioritize safety features, well-rated drivers, tracked rides |
80| Foreign country | Find local apps, check cash/card acceptance, language tips |
81| Large group | Calculate split options, find vans/minibuses, coordinate multiple cars |
82| Accessibility | Filter for wheelchair-accessible, verify with company if needed |
83| With pets | Find pet-friendly options, carrier requirements |
84| With kids | Car seat availability, family-friendly services |
85| VIP/Executive | Car services, black car, chauffeur options |
86| Event pickup | Coordinate pickup points, surge avoidance strategies |
87
88### 6. Track Everything
89Log in `~/taxi/trips.md`:
90- Date, route, app used
91- Price paid, promo applied
92- Category (personal, business, specific project)
93- Notes (late driver, surge, issues)
94
95Provide:
96- Monthly expense summaries
97- Per-category totals
98- Comparison vs public transit
99- Year-over-year trends
100
101### 7. Resolve Problems
102When user has issue:
1031. Identify problem type (overcharge, route, driver, safety, lost item)
1042. Find correct channel (in-app, email, phone, social)
1053. Draft complaint with relevant details
1064. Track resolution status
1075. Escalate if no response (BBB, local regulator, social media)
108
109See `problems.md` for dispute workflows by app.
110
111### 8. Stay Current
112- Check for new apps entering user's city
113- Monitor promo code sources (RetailMeNot, Honey, app-specific)
114- Track regulatory changes (some cities ban/restrict services)
115- Know seasonal patterns (holiday surge, airport construction)
116
117### 9. Multi-Modal Integration
118Sometimes taxi isn't best option:
119- Compare with public transit for cost/time
120- Suggest train + last-mile rideshare
121- Rental car for multi-day or multi-stop
122- Hotel shuttle for airport
123- Walking + rideshare vs door-to-door
124
125### 10. Privacy & Security
126- Never store full payment details
127- Mask home address in logs if user prefers
128- Share trip tracking with emergency contacts
129- Verify driver details before user enters vehicle
130
131## Common Traps
132
133- Booking without checking surge → Always show current multiplier
134- Assuming one app works everywhere → Check local alternatives first
135- Ignoring scheduled ride option → Often 10-20% cheaper
136- Not logging business trips immediately → Harder to categorize later
137- Using first promo code found → Some stack, some conflict, check terms
138- Recommending cheapest without context → Safety/reliability matter for some trips
139- Forgetting airport rules → Designated pickup areas, terminal-specific pricing
140- Not tracking flight delays → User waits, ride leaves or charges wait time
141- Ignoring user's past preferences → Check memory before suggesting