Local-First
Open tasks live in SQLite on your machine. Nothing leaves your computer until you schedule something or sync.
Tasks + Calendar + Google Meet · TUI + Agent-Native
Your calendar speaks shell
your agent gets it
Local-first tasks with Google Calendar or Apple Calendar sync. Create Google Meet events, invite guests, respond to invitations, and join from the TUI, CLI, or your agent.
brew tap alexapvl/mytime https://github.com/alexapvl/mytime && brew install mytime
Why mytime
Local, Synced, Meeting-Ready
Capture tasks locally, schedule them when ready, and use the same calendar CLI workflow in your terminal, shell scripts, and agent sessions.
Calendar + Meetings
Sync Google or Apple Calendar. With Google active, create Meet events, invite guests, RSVP, and open the call without leaving the terminal.
Agent-Ready
mytime agent exposes the same database with token-efficient
output and next-step hints. MCP is still available for older clients.
Workflow
From Backlog to Calendar
mytime is built around a simple loop: capture without pressure, schedule when it matters, then see the day in one terminal view.
1. Capture
Add tasks with quick-add NLP, priorities, projects, and tags. Unscheduled work stays in the backlog until you are ready.
2. Schedule
Pick a slot from free-time hints, move blocks by hour, or mark something all-day. The schedule editor shows what is already on the day.
3. Live It
Daily, week, and month views keep tasks and external calendar events in one place. Sync keeps the active provider and local state aligned.
mytime - tasks + calendar
· r sync · u undo · esc quit
←/→ priority · ↑/↓ navigate · ⇧←/→ move priority · a add · q quick-add · e edit · s schedule · x done · d delete
P0
▸ ship terminal demo
fix sync edge case
P1
review PR @work
grocery run
P2
write release notes
update onboarding docs
P3
read Rust book ch. 4
ship terminal demo · #mytime · created Jul 12
←/→ day · t today · ↑/↓ select · a add task · q quick-add · ⇧a add event · ⇧q quick-event · e edit · s reschedule
all day · release prep
00:00 ·
01:00 ·
02:00 ·
03:00 ·
04:00 ·
05:00 ·
06:00 ·
07:00 ·
08:00 ·
09:00-09:30 · standup #gcal
10:00 ·
11:00-12:30 ▸ ship terminal demo
12:00 ·
13:00 ·
14:00-15:00 · review PR @work
15:30-16:00 · sync with Sam #gcal
16:00 ·
17:00 ·
18:00 ·
19:00 ·
20:00 ·
21:00 ·
22:00 ·
23:00 ·
←/→ day · ⇧←/→ week · t today · ↑/↓ select · a add task · q quick-add · ⇧a add event · ⇧q quick-event · e edit · s reschedule
Mon 13 Jul (today)
09:00 standup
▸ 11:00 ship terminal demo
15:30 sync with Sam
Tue 14 Jul
10:00 dentist
14:00 review PR @work
Wed 15 Jul
09:00 standup
write release notes
Thu 16 Jul
11:00 fix sync edge case
Fri 17 Jul
16:00 weekly review
Sat 18 Jul
no events
Sun 19 Jul
no events
←/→ day · ↑/↓ week · ⇧←/→ month · t today · enter open day · a add task · q quick-add · ⇧a add event · ⇧q quick-event
Mon 29
Tue 30
Wed 1
09:00 standup
Thu 2
ship site SEO
Fri 3
14:00 design review
Sat 4
Sun 5
6
10:00 planning
7
write release notes
8
9
15:30 sync with Sam
10
grocery run
11
12
▸ Mon 13
09:00 standup
11:00 ship terminal demo
15:30 sync with Sam
14
10:00 dentist
review PR @work
15
09:00 standup
16
fix sync edge case
17
16:00 weekly review
18
19
20
09:00 standup
21
22
release v0.4.0
23
24
12:00 lunch with Mia
25
26
27
09:00 standup
28
29
read Rust ch. 4
30
31
16:00 monthly review
Sat 1
Sun 2
↑/↓ navigate · e edit · s reschedule · x done · d delete
▸ renew domainJul 10 · 3 days overdue
· send project invoiceJul 8 · 5 days overdue
· book dentist appointmentJul 6 · 7 days overdue
· update expense sheetJun 30 · 13 days overdue
Calendar connected
For Agents
Setup Your Agent Can Do Most Of
Your agent asks whether you want Google or Apple when it cannot infer the provider from context. It can handle most of setup, but you approve Google sign-in or the macOS Calendar permission prompt.
mytime setup --agent-onboarding-prompt
Paste the onboarding prompt into your agent after install. Your agent gets the same backlog, schedule, slots, and sync tools you do.
# made for agents - TOON output, contextual hints (axi.md)
$ mytime agent
backlog 4 open
p0 ship mytime site
p1 review PR @work · tomorrow 3pm
today Sun Jul 12
09:00 standup
15:00 review PR @work
past due 0
help:
mytime agent task quick "dentist Fri 2pm"
mytime agent slots --date tomorrow
mytime agent sync
Setup
Install, Configure, Authenticate
Choose Google Calendar or Apple Calendar, then keep one writable provider active.
Install first, then let your agent ask which calendar provider you want.
01
Install mytime
Homebrew is the fastest path on macOS. Source install works anywhere with Node 20+.
brew tap alexapvl/mytime https://github.com/alexapvl/mytime && brew install mytime
02
Run agent onboarding
Paste this prompt into your agent. It must ask Google or Apple when your choice is unknown, then start the correct setup flow.
mytime setup --agent-onboarding-prompt
02
Choose Google or Apple
Google uses browser OAuth. Apple uses Calendar.app and requires macOS 14 or newer.
mytime setup google
mytime setup apple
03
Approve and sync
Complete Google sign-in or approve the macOS Calendar permission prompt. Sync then creates the dedicated mytime calendar on the active provider.
mytime sync
Privacy
Your Machine, Your Calendar
mytime does not ship shared OAuth credentials. That is intentional for a personal, local-first tool.
No Hosted Service
Tasks and provider data stay under ~/.mytime/. There is no maintainer server in the loop.
Write Scope Is Narrow
Tasks sync to mytime's dedicated calendar. Google Meet events use your primary calendar so invitations come from you. Other calendars stay read-only.
You Stay in Control
Revoke Google OAuth or Apple Calendar access any time. Your agent never needs calendar secrets in git.
FAQ
Common Questions
Ready to Try It?
Install, run setup, and open the TUI. Your backlog is waiting.
brew tap alexapvl/mytime https://github.com/alexapvl/mytime && brew install mytime