r_cal 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 94b9764871e9a1c0265ddba97c60df40b405b8123d8ed948161e5ce282f11047
+  data.tar.gz: 8be2bb3df5dae0b2df5aba144076f938358817bbb9a4056756a77e9b4f59c48f
+SHA512:
+  metadata.gz: a93938c290893283cccaa9e9cf3221abeb44711752faae4d080bccaf6338dfbdeaecb4ebe2f22e7464cb268b782dd3cef2edb77b7e3e4057552a6beb6300657f
+  data.tar.gz: 855962fb33a37677c0c42a7dba07ec3ed6473da9bf9d31b8024abc16d49e5d46c1e73e43239b530988ac27143a905b295b0b00e5c6315d5f0dc4ee675dc1c07d

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,239 @@
+PATH
+  remote: .
+  specs:
+    rcal (0.1.0)
+      chronic (~> 0.10)
+      chronic_duration (~> 0.10)
+      cli-kit (~> 5.2.0)
+      cli-ui (~> 2.7.0)
+      google-apis-calendar_v3 (~> 0.30)
+      googleauth (~> 1.8)
+      icalendar (~> 2.10)
+      launchy (~> 2.4)
+      pstore
+      readline
+      reline
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
+    ansi (1.5.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    builder (3.3.0)
+    chronic (0.10.2)
+    chronic_duration (0.10.6)
+      numerizer (~> 0.1.1)
+    cli-kit (5.2.0)
+      cli-ui (~> 2.4)
+    cli-ui (2.7.0)
+    declarative (0.0.20)
+    faraday (2.14.0)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-follow_redirects (0.5.0)
+      faraday (>= 1, < 3)
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    google-apis-calendar_v3 (0.51.0)
+      google-apis-core (>= 0.15.0, < 2.a)
+    google-apis-core (1.0.2)
+      addressable (~> 2.8, >= 2.8.7)
+      faraday (~> 2.13)
+      faraday-follow_redirects (~> 0.3)
+      googleauth (~> 1.14)
+      mini_mime (~> 1.1)
+      representable (~> 3.0)
+      retriable (~> 3.1)
+    google-cloud-env (2.3.1)
+      base64 (~> 0.2)
+      faraday (>= 1.0, < 3.a)
+    google-logging-utils (0.2.0)
+    googleauth (1.16.1)
+      faraday (>= 1.0, < 3.a)
+      google-cloud-env (~> 2.2)
+      google-logging-utils (~> 0.1)
+      jwt (>= 1.4, < 4.0)
+      multi_json (~> 1.11)
+      os (>= 0.9, < 2.0)
+      signet (>= 0.16, < 2.a)
+    icalendar (2.12.1)
+      base64
+      ice_cube (~> 0.16)
+      logger
+      ostruct
+    ice_cube (0.17.0)
+    io-console (0.8.2)
+    json (2.18.0)
+    jwt (3.1.2)
+      base64
+    language_server-protocol (3.17.0.5)
+    launchy (2.5.2)
+      addressable (~> 2.8)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    mini_mime (1.1.5)
+    minitest (5.27.0)
+    minitest-reporters (1.7.1)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    mocha (2.8.2)
+      ruby2_keywords (>= 0.0.5)
+    multi_json (1.19.1)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    numerizer (0.1.1)
+    os (1.1.4)
+    ostruct (0.6.3)
+    parallel (1.27.0)
+    parser (3.3.10.1)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    pstore (0.2.0)
+    public_suffix (7.0.2)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    readline (0.0.4)
+      reline
+    regexp_parser (2.11.3)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    representable (3.2.0)
+      declarative (< 0.1.0)
+      trailblazer-option (>= 0.1.1, < 0.2.0)
+      uber (< 0.2.0)
+    retriable (3.1.2)
+    rubocop (1.82.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    ruby2_keywords (0.0.5)
+    signet (0.21.0)
+      addressable (~> 2.8)
+      faraday (>= 0.17.5, < 3.a)
+      jwt (>= 1.5, < 4.0)
+      multi_json (~> 1.10)
+    standard (1.53.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.82.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
+    timecop (0.9.10)
+    trailblazer-option (0.1.2)
+    uber (0.1.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+
+PLATFORMS
+  arm64-darwin-25
+  ruby
+
+DEPENDENCIES
+  minitest (~> 5.20)
+  minitest-reporters
+  mocha (~> 2.1)
+  rake
+  rcal!
+  standard
+  timecop (~> 0.9)
+
+CHECKSUMS
+  addressable (2.8.8) sha256=7c13b8f9536cf6364c03b9d417c19986019e28f7c00ac8132da4eb0fe393b057
+  ansi (1.5.0) sha256=5408253274e33d9d27d4a98c46d2998266fd51cba58a7eb9d08f50e57ed23592
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
+  builder (3.3.0) sha256=497918d2f9dca528fdca4b88d84e4ef4387256d984b8154e9d5d3fe5a9c8835f
+  chronic (0.10.2) sha256=766f2fcce6ac3cc152249ed0f2b827770d3e517e2e87c5fba7ed74f4889d2dc3
+  chronic_duration (0.10.6) sha256=fac58d4147d3183a40811400380cafcef049f2bb02421d2fd1c6e685fbe8facc
+  cli-kit (5.2.0) sha256=6eb44b6648fb644e801c8d05cbc85e4a7ea5c5fc2b42d2312e2ea78606a3be7d
+  cli-ui (2.7.0) sha256=e36147f2e8088796b996f0560f577bd1599f2b6aa3c374fe09fff59af5589c35
+  declarative (0.0.20) sha256=8021dd6cb17ab2b61233c56903d3f5a259c5cf43c80ff332d447d395b17d9ff9
+  faraday (2.14.0) sha256=8699cfe5d97e55268f2596f9a9d5a43736808a943714e3d9a53e6110593941cd
+  faraday-follow_redirects (0.5.0) sha256=5cde93c894b30943a5d2b93c2fe9284216a6b756f7af406a1e55f211d97d10ad
+  faraday-net_http (3.4.2) sha256=f147758260d3526939bf57ecf911682f94926a3666502e24c69992765875906c
+  google-apis-calendar_v3 (0.51.0) sha256=ed2647ee7d58e79c5e510935d012396de6f6649a435359a4380d58d3b13fce05
+  google-apis-core (1.0.2) sha256=ba4579aaadc902d6cc7bc8db88f566ab00f5e31ea87ab41e9f9a032c470f2629
+  google-cloud-env (2.3.1) sha256=0faac01eb27be78c2591d64433663b1a114f8f7af55a4f819755426cac9178e7
+  google-logging-utils (0.2.0) sha256=675462b4ea5affa825a3442694ca2d75d0069455a1d0956127207498fca3df7b
+  googleauth (1.16.1) sha256=36776bce9d55d8c1a0c6638c939b000dcee5954ca5b728f06ec4c2df4a46709c
+  icalendar (2.12.1) sha256=ecff56c550aed551f29ad1faad0da54bf62362dfaf22a428bd7ad782938fe764
+  ice_cube (0.17.0) sha256=32deb45dda4b4acc53505c2f581f6d32b5afc04d29b9004769944a0df5a5fcbe
+  io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
+  json (2.18.0) sha256=b10506aee4183f5cf49e0efc48073d7b75843ce3782c68dbeb763351c08fd505
+  jwt (3.1.2) sha256=af6991f19a6bb4060d618d9add7a66f0eeb005ac0bc017cd01f63b42e122d535
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  launchy (2.5.2) sha256=8aa0441655aec5514008e1d04892c2de3ba57bd337afb984568da091121a241b
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
+  mini_mime (1.1.5) sha256=8681b7e2e4215f2a159f9400b5816d85e9d8c6c6b491e96a12797e798f8bccef
+  minitest (5.27.0) sha256=2d3b17f8a36fe7801c1adcffdbc38233b938eb0b4966e97a6739055a45fa77d5
+  minitest-reporters (1.7.1) sha256=5060413a0c95b8c32fe73e0606f3631c173a884d7900e50013e15094eb50562c
+  mocha (2.8.2) sha256=1f77e729db47e72b4ef776461ce20caeec2572ffdf23365b0a03608fee8f4eee
+  multi_json (1.19.1) sha256=7aefeff8f2c854bf739931a238e4aea64592845e0c0395c8a7d2eea7fdd631b7
+  net-http (0.9.1) sha256=25ba0b67c63e89df626ed8fac771d0ad24ad151a858af2cc8e6a716ca4336996
+  numerizer (0.1.1) sha256=10ec9efec62472b69a3a0e275a18a44baa595ce6e2e4cfc1678d5cb2974c336f
+  os (1.1.4) sha256=57816d6a334e7bd6aed048f4b0308226c5fb027433b67d90a9ab435f35108d3f
+  ostruct (0.6.3) sha256=95a2ed4a4bd1d190784e666b47b2d3f078e4a9efda2fccf18f84ddc6538ed912
+  parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
+  parser (3.3.10.1) sha256=06f6a725d2cd91e5e7f2b7c32ba143631e1f7c8ae2fb918fc4cebec187e6a688
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  pstore (0.2.0) sha256=d6e5c7e8e22392235e88bbe82959059ba768a797b5bd0ebf5ac80a3311ce74a8
+  public_suffix (7.0.2) sha256=9114090c8e4e7135c1fd0e7acfea33afaab38101884320c65aaa0ffb8e26a857
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
+  rcal (0.1.0)
+  readline (0.0.4) sha256=6138eef17be2b98298b672c3ea63bf9cb5158d401324f26e1e84f235879c1d6a
+  regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
+  reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
+  representable (3.2.0) sha256=cc29bf7eebc31653586849371a43ffe36c60b54b0a6365b5f7d95ec34d1ebace
+  retriable (3.1.2) sha256=0a5a5d0ca4ba61a76fb31a17ab8f7f80281beb040c329d34dfc137a1398688e0
+  rubocop (1.82.1) sha256=09f1a6a654a960eda767aebea33e47603080f8e9c9a3f019bf9b94c9cab5e273
+  rubocop-ast (1.49.0) sha256=49c3676d3123a0923d333e20c6c2dbaaae2d2287b475273fddee0c61da9f71fd
+  rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  ruby2_keywords (0.0.5) sha256=ffd13740c573b7301cf7a2e61fc857b2a8e3d3aff32545d6f8300d8bae10e3ef
+  signet (0.21.0) sha256=d617e9fbf24928280d39dcfefba9a0372d1c38187ffffd0a9283957a10a8cd5b
+  standard (1.53.0) sha256=f3c9493385db7079d0abce6f7582f553122156997b81258cd361d3480eeacf9c
+  standard-custom (1.0.2) sha256=424adc84179a074f1a2a309bb9cf7cd6bfdb2b6541f20c6bf9436c0ba22a652b
+  standard-performance (1.9.0) sha256=49483d31be448292951d80e5e67cdcb576c2502103c7b40aec6f1b6e9c88e3f2
+  timecop (0.9.10) sha256=12ba45ce57cdcf6b1043cb6cdffa6381fd89ce10d369c28a7f6f04dc1b0cd8eb
+  trailblazer-option (0.1.2) sha256=20e4f12ea4e1f718c8007e7944ca21a329eee4eed9e0fa5dde6e8ad8ac4344a3
+  uber (0.1.0) sha256=5beeb407ff807b5db994f82fa9ee07cfceaa561dad8af20be880bc67eba935dc
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+  uri (1.1.1) sha256=379fa58d27ffb1387eaada68c749d1426738bd0f654d812fcc07e7568f5c57c6
+
+BUNDLED WITH
+  4.0.3

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Drew Bragg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,174 @@
+# rcal
+
+A fast, pure Ruby command-line interface for Google Calendar.
+
+## Features
+
+- **Natural language dates** - "tomorrow 3pm", "next monday", "friday noon"
+- **Event management** - create, edit, and view events
+- **ICS import** - import calendar invites from .ics files
+- **Predicate filtering** - filter by recurring, one-on-one, declined, etc.
+- **Multiple calendars** - work with any calendar in your account
+- **Fast startup** - built with cli-kit for snappy performance
+
+## Installation
+
+```bash
+git clone https://github.com/yourusername/rcal.git
+cd rcal
+bundle install
+```
+
+## Setup
+
+1. Create OAuth credentials in [Google Cloud Console](https://console.cloud.google.com/apis/credentials):
+   - Create a new project (or use existing)
+   - Enable the Google Calendar API
+   - Create OAuth 2.0 Client ID (Desktop app type)
+   - Note your Client ID and Client Secret
+
+2. Authenticate rcal:
+
+```bash
+rcal init --client-id=YOUR_CLIENT_ID --client-secret=YOUR_CLIENT_SECRET
+```
+
+## Usage
+
+### View Events
+
+```bash
+# Today's agenda
+rcal agenda
+
+# Tomorrow
+rcal agenda tomorrow
+
+# Next 7 days
+rcal agenda --days=7
+
+# Specific date range
+rcal agenda "next monday" "next friday"
+
+# Filter by predicates
+rcal agenda --must-be=recurring
+rcal agenda --must-not-be=declined,all_day
+
+# Show event IDs (for editing)
+rcal agenda --show-ids
+```
+
+### Create Events
+
+```bash
+# Quick add with natural language
+rcal quick "Lunch with Sarah tomorrow noon"
+rcal quick "Team standup every weekday 10am"
+
+# Structured add
+rcal add --title="Team Meeting" --when="tomorrow 3pm"
+rcal add --title="Lunch" --when="friday noon" --duration=1h30m --location="Cafe"
+rcal add --title="Vacation" --when="monday" --all-day
+```
+
+### Edit Events
+
+```bash
+# Get event ID from agenda
+rcal agenda --show-ids
+
+# Edit event
+rcal edit EVENT_ID --title="Updated Title"
+rcal edit EVENT_ID --when="tomorrow 4pm" --duration=30m
+rcal edit EVENT_ID --location="Room 202"
+```
+
+### Import ICS Files
+
+```bash
+# Import calendar invite
+rcal import ~/Downloads/invite.ics
+
+# Import to specific calendar
+rcal import meeting.ics --calendar=work@company.com
+```
+
+### List Calendars
+
+```bash
+rcal list
+```
+
+## Available Predicates
+
+Use with `--must-be` and `--must-not-be` flags:
+
+| Predicate | Description |
+|-----------|-------------|
+| `accepted` | Events you've accepted |
+| `declined` | Events you've declined |
+| `awaiting` | Events awaiting your response |
+| `tentative` | Events you've tentatively accepted |
+| `all_day` | All-day events |
+| `recurring` | Recurring events |
+| `one_on_one` | Events with exactly 2 attendees |
+| `busy` | Events that block your calendar |
+| `commitment` | Events with 2+ attendees you haven't declined |
+
+## Duration Formats
+
+- `30m` - 30 minutes
+- `1h` - 1 hour
+- `1h30m` - 1 hour 30 minutes
+- `1.5h` - 1.5 hours (90 minutes)
+- `2h15m` - 2 hours 15 minutes
+
+## Configuration
+
+rcal follows XDG Base Directory specification:
+
+- Config: `~/.config/rcal/`
+- Data: `~/.local/share/rcal/`
+
+## Development
+
+```bash
+# Run all tests and linter
+bundle exec rake
+
+# Run all tests
+bundle exec rake test
+
+# Run unit tests only
+bundle exec rake test:unit
+
+# Run linter
+bundle exec rake lint
+
+# Run linter with auto-fix
+bundle exec rake lint:fix
+
+# List all available tasks
+bundle exec rake -T
+
+# Run CLI locally
+./exe/rcal help
+```
+
+## Architecture
+
+rcal uses an adapter pattern for all external dependencies:
+
+```
+Rcal::DateParser      -> Rcal::Adapters::DateParser::Chronic
+Rcal::DurationParser  -> Rcal::Adapters::DurationParser::ChronicDuration
+Rcal::IcsParser       -> Rcal::Adapters::IcsParser::Icalendar
+Rcal::CalendarService -> Rcal::Adapters::Calendar::Google
+Rcal::Auth            -> Rcal::Adapters::Auth::Google
+```
+
+This allows swapping implementations without changing application code.
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "rake/testtask"
+require "standard/rake"
+
+#
+# Test tasks
+#
+desc "Run all tests"
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+desc "Run unit tests only"
+Rake::TestTask.new("test:unit") do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/unit/**/*_test.rb"]
+end
+
+desc "Run integration tests only"
+Rake::TestTask.new("test:integration") do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/integration/**/*_test.rb"]
+end
+
+#
+# Lint tasks
+#
+desc "Run StandardRB linter"
+task :lint do
+  sh "bundle exec standardrb"
+end
+
+desc "Run StandardRB linter and auto-fix"
+task "lint:fix" do
+  sh "bundle exec standardrb --fix"
+end
+
+#
+# Default task
+#
+desc "Run tests and linter"
+task default: [:test, :lint]

data/dev.yml

@@ -0,0 +1,3 @@
+up:
+  - ruby: 4.0.1
+  - bundler

data/exe/rcal

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+Encoding.default_external = Encoding::UTF_8
+Encoding.default_internal = Encoding::UTF_8
+
+unshift_path = ->(path) {
+  p = File.expand_path("../../#{path}", __FILE__)
+  $LOAD_PATH.unshift(p) unless $LOAD_PATH.include?(p)
+}
+unshift_path.call("lib")
+
+require "bundler/setup"
+require "rcal"
+
+exit(Rcal::ErrorHandler.call do
+  Rcal::EntryPoint.call(ARGV.dup)
+end)

data/lib/rcal/adapters/auth/base.rb

@@ -0,0 +1,27 @@
+module Rcal
+  module Adapters
+    module Auth
+      class Base
+        def store_credentials(credentials)
+          raise NotImplementedError, "#{self.class} must implement #store_credentials"
+        end
+
+        def load_credentials
+          raise NotImplementedError, "#{self.class} must implement #load_credentials"
+        end
+
+        def authenticated?
+          raise NotImplementedError, "#{self.class} must implement #authenticated?"
+        end
+
+        def token_expired?
+          raise NotImplementedError, "#{self.class} must implement #token_expired?"
+        end
+
+        def clear_credentials
+          raise NotImplementedError, "#{self.class} must implement #clear_credentials"
+        end
+      end
+    end
+  end
+end

data/lib/rcal/adapters/auth/google.rb

@@ -0,0 +1,71 @@
+require "json"
+require "fileutils"
+require_relative "base"
+
+module Rcal
+  module Adapters
+    module Auth
+      class Google < Base
+        def self.default_token_path
+          base = ENV.fetch("XDG_DATA_HOME") { File.join(ENV.fetch("HOME"), ".local", "share") }
+          File.join(base, "rcal", "tokens.json")
+        end
+
+        def initialize(token_path: self.class.default_token_path)
+          @token_path = token_path
+        end
+
+        def store_credentials(credentials)
+          ensure_directory_exists
+
+          token_data = {
+            "access_token" => credentials.access_token,
+            "refresh_token" => credentials.refresh_token,
+            "expires_at" => credentials.expires_at.to_i
+          }
+
+          File.write(@token_path, JSON.generate(token_data))
+          File.chmod(0o600, @token_path)
+        end
+
+        def load_credentials
+          return nil unless File.exist?(@token_path)
+
+          JSON.parse(File.read(@token_path))
+        rescue JSON::ParserError
+          nil
+        end
+
+        def authenticated?
+          creds = load_credentials
+          return false if creds.nil?
+
+          # Need at least a refresh token to be considered authenticated
+          # (we can refresh expired access tokens)
+          !creds["refresh_token"].nil? && !creds["refresh_token"].empty?
+        end
+
+        def token_expired?
+          creds = load_credentials
+          return true if creds.nil?
+
+          expires_at = creds["expires_at"]
+          return true if expires_at.nil?
+
+          Time.at(expires_at) <= Time.now
+        end
+
+        def clear_credentials
+          FileUtils.rm_f(@token_path)
+        end
+
+        private
+
+        def ensure_directory_exists
+          dir = File.dirname(@token_path)
+          FileUtils.mkdir_p(dir) unless File.directory?(dir)
+        end
+      end
+    end
+  end
+end

data/lib/rcal/adapters/calendar/base.rb

@@ -0,0 +1,35 @@
+module Rcal
+  module Adapters
+    module Calendar
+      class Base
+        def list_calendars
+          raise NotImplementedError, "#{self.class} must implement #list_calendars"
+        end
+
+        def list_events(calendar_id:, time_min:, time_max:)
+          raise NotImplementedError, "#{self.class} must implement #list_events"
+        end
+
+        def get_event(calendar_id:, event_id:)
+          raise NotImplementedError, "#{self.class} must implement #get_event"
+        end
+
+        def create_event(calendar_id:, event:)
+          raise NotImplementedError, "#{self.class} must implement #create_event"
+        end
+
+        def update_event(calendar_id:, event_id:, event:)
+          raise NotImplementedError, "#{self.class} must implement #update_event"
+        end
+
+        def delete_event(calendar_id:, event_id:)
+          raise NotImplementedError, "#{self.class} must implement #delete_event"
+        end
+
+        def quick_add(calendar_id:, text:)
+          raise NotImplementedError, "#{self.class} must implement #quick_add"
+        end
+      end
+    end
+  end
+end