Fellow Aiden ☕

Control your Fellow Aiden smart coffee brewer via chat.

Setup

Set your Fellow account credentials as environment variables:

[email protected]
FELLOW_PASSWORD=yourpassword

The skill will handle authentication automatically.

---

What You Can Do

Brewer Info

Ask things like: - "What's my brewer called?" - "Show me my Aiden's status" - "What firmware is my brewer on?"

python3 {baseDir}/fellow.py info

---

Profiles

Brew profiles control every parameter of your brew: water temperature, bloom, pulse intervals, and more.

List all profiles:

python3 {baseDir}/fellow.py profiles list

Get a specific profile (by title, fuzzy match supported):

python3 {baseDir}/fellow.py profiles get --title "Light Roast"
python3 {baseDir}/fellow.py profiles get --title "light" --fuzzy
python3 {baseDir}/fellow.py profiles get --id p3

Create a new profile:

python3 {baseDir}/fellow.py profiles create 
  --title "My Morning Brew" 
  --ratio 15 
  --bloom 
  --bloom-ratio 2 
  --bloom-duration 30 
  --bloom-temp 96 
  --ss-pulses 3 
  --ss-interval 20 
  --ss-temps "96,97,98" 
  --batch-pulses 2 
  --batch-interval 30 
  --batch-temps "96,97"

Delete a profile:

python3 {baseDir}/fellow.py profiles delete --id p3
python3 {baseDir}/fellow.py profiles delete --title "Old Recipe" --fuzzy

Import a profile from a brew.link share URL:

python3 {baseDir}/fellow.py profiles import --url "https://brew.link/p/ws98"

Share a profile (generates a brew.link URL):

python3 {baseDir}/fellow.py profiles share --id p2
python3 {baseDir}/fellow.py profiles share --title "My Favorite"

---

Schedules

Schedules let the Aiden brew automatically on a weekly timer.

List all schedules:

python3 {baseDir}/fellow.py schedules list

Create a schedule:

Days are specified as a comma-separated list: sun,mon,tue,wed,thu,fri,sat

Time is specified as HH:MM in 24-hour format (local time is converted to seconds-from-midnight automatically).

# Brew every weekday at 7:30am, 950ml, using profile p2
python3 {baseDir}/fellow.py schedules create 
  --days "mon,tue,wed,thu,fri" 
  --time "07:30" 
  --water 950 
  --profile-id p2

# Brew Mon/Wed/Fri at 8:00am
python3 {baseDir}/fellow.py schedules create 
  --days "mon,wed,fri" 
  --time "08:00" 
  --water 750 
  --profile-id p0

Delete a schedule:

python3 {baseDir}/fellow.py schedules delete --id s0

---

Usage Guidance for the Agent

• When the user asks to "brew" or mentions coffee, check their profiles first and suggest relevant ones.
• Profile titles support fuzzy matching — you don't need an exact match.
• Water amount is in millilitres (150–1500ml).
• Temperatures are in Celsius.
• Profile IDs look like p0, p1, etc. Schedule IDs look like s0, s1, etc.
• When creating a profile from natural language (e.g. "make me a light roast profile"), use sensible defaults:
• ratio: 15–17 for lighter roasts, 14–15 for darker
• bloom: enabled, bloomRatio 2, bloomDuration 30s
• temperatures: 90–93°C for light, 93–96°C for medium, 96–98°C for dark
• Always confirm with the user before deleting profiles or schedules.
• When sharing a profile, present the brew.link URL clearly so the user can copy it.
• The --fuzzy flag on profiles get and profiles delete enables approximate title matching — use it when the user gives an informal name.