google-workspace-cli 0.1.0__tar.gz

google_workspace_cli-0.1.0/.claude/commands/quality.md

@@ -0,0 +1,21 @@
+Run all quality checks.
+
+Steps:
+1. Lint:
+   ```
+   uv run ruff check src/ tests/
+   ```
+2. Format check:
+   ```
+   uv run ruff format --check src/ tests/
+   ```
+3. Type check:
+   ```
+   uv run pyright src/
+   ```
+4. Tests:
+   ```
+   uv run pytest tests/ -v
+   ```
+
+Report any issues found. If fixable, ask to auto-fix (`ruff check --fix`, `ruff format`).

google_workspace_cli-0.1.0/.claude/commands/release.md

@@ -0,0 +1,77 @@
+---
+description: Bump version, commit, tag, and push a release
+arguments:
+  - name: level
+    description: "patch, minor, or major"
+    required: true
+---
+
+Release gw-cli with a version bump.
+
+## Prerequisites
+
+Before releasing, ensure:
+1. `/quality` has been run and passes
+2. Current branch is `master`
+
+## Steps
+
+### 1. Validate preconditions
+
+- Argument: `$ARGUMENTS` (must be `patch`, `minor`, or `major`)
+- Verify current branch is `master` (`git branch --show-current`). Abort if not.
+
+### 2. Read current version
+
+Read `src/gw/__init__.py` and extract `__version__`.
+
+### 3. Calculate new version
+
+Apply SemVer bump:
+- `patch`: 0.1.0 → 0.1.1
+- `minor`: 0.1.0 → 0.2.0
+- `major`: 0.1.0 → 1.0.0
+
+(While MAJOR is 0, treat breaking changes as `minor`.)
+
+### 4. Update version in all three locations
+
+Keep these in lockstep (see `.claude/rules/versioning.md`):
+1. `src/gw/__init__.py` → `__version__`
+2. `.claude-plugin/plugin.json` → `version`
+3. `.claude-plugin/marketplace.json` → `plugins[0].version`
+
+### 5. Lock and build
+
+```bash
+uv lock
+uv build
+```
+
+Verify the build produces `dist/google_workspace_cli-X.Y.Z-*.whl` and `dist/google_workspace_cli-X.Y.Z.tar.gz`.
+
+### 6. Commit and tag
+
+```bash
+git add src/gw/__init__.py .claude-plugin/plugin.json .claude-plugin/marketplace.json uv.lock
+git commit -m "chore(release): vX.Y.Z"
+git tag vX.Y.Z
+```
+
+### 7. Push
+
+```bash
+git push && git push --tags
+```
+
+This triggers the `Publish to PyPI` workflow → publishes `google-workspace-cli` to PyPI and creates a GitHub Release.
+
+### 8. Update CHANGELOG and write release notes
+
+1. `git log --oneline vPREVIOUS..vX.Y.Z` to review commits in this release.
+2. Add a new section to the top of `CHANGELOG.md` for `vX.Y.Z`.
+3. Write release notes grouped as **New features** / **Improvements** / **Bug fixes** (omit empty sections), referencing issue/PR numbers with `#N`. Add a `## Migration` section if any commit is a breaking change.
+
+### 9. Report
+
+Print the new version, the GitHub Release link, and the Actions run URL.

google_workspace_cli-0.1.0/.claude/commands/self-review.md

@@ -0,0 +1,48 @@
+Perform a pre-PR self-review of all changes.
+
+## Role
+
+You are an AI code reviewer. Review only the modified code in the diff. Prioritize high-signal feedback over quantity.
+
+## Review the diff
+
+```bash
+git diff master...HEAD
+```
+
+If no diff, review `git diff HEAD~1`.
+
+## Review for (in priority order)
+
+1. **Correctness** — bugs, edge cases, broken logic, unreachable code
+2. **Security** — credential/token leaks, secrets in logs, unsafe defaults, committing `credentials.json`/tokens
+3. **Error handling** — exceptions swallowed, auth errors not surfacing a recovery hint, missing input validation (`click.BadParameter`)
+4. **Test coverage** — every changed/added code path must have a test. Check: new branches, error paths, edge cases
+5. **CLI behavior** — `--json` / `--account` honored, output routed through `format_output`, help text accurate
+6. **Consistency** — patterns used differently across files, naming inconsistencies with existing code
+
+## Rules
+
+- Only comment on lines that were changed in the diff
+- Be specific and actionable — suggest concrete fixes
+- Do not nitpick formatting (ruff handles it)
+
+## Severity
+
+| Marker | Meaning | Action |
+|--------|---------|--------|
+| `[C]` | Bug, security hole, data loss | Must fix before merge |
+| `[W]` | Risk, missing guard, edge case | Should fix |
+| `[I]` | Readability, minor improvement | Fix or justify |
+
+## Output
+
+```markdown
+## Self-review: X files changed
+
+`[C]` file:line — Description. **Fix:** concrete suggestion.
+
+### Verdict: Ready / Needs fixes
+```
+
+If no significant issues: state "Changes look good" with a brief summary.

google_workspace_cli-0.1.0/.claude/commands/test.md

@@ -0,0 +1,8 @@
+Run the test suite.
+
+Steps:
+1. Run all tests:
+   ```
+   uv run pytest tests/ -v --maxfail=5
+   ```
+2. Report results: passed/failed/skipped counts and failing test names.

google_workspace_cli-0.1.0/.claude/rules/development-workflow.md

@@ -0,0 +1,31 @@
+---
+paths:
+  - "**"
+---
+
+# Development Workflow
+
+## Flow
+
+1. **Start**: `gh issue view <number>` → understand the task
+2. **Branch**: `git checkout -b {issue-number}-{type}/{description} master`
+3. **Implement**: Write code keeping self-review criteria in mind from the start
+4. **Quality**: Run `/quality` (lint, format, type-check, tests)
+5. **Self-review**: Run `/self-review` — fix all `[C]` and `[W]` findings
+6. **PR**: Create PR linking the issue. Only when the user explicitly asks.
+7. **Merge**: Only after user approval. Never auto-merge.
+
+## Commit Discipline
+
+- Commit frequently with meaningful messages
+- Follow Conventional Commits: `<type>(<scope>): <subject>`
+- Each commit should be atomic — one logical change per commit
+- Types: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`, `ci`
+
+## PR Rules
+
+- Run `/quality` → `/self-review` before every PR
+- PR title: Under 70 characters, Conventional Commits format
+- Squash merge to `master`
+- Delete branch after merge
+- Never skip self-review before merge

google_workspace_cli-0.1.0/.claude/rules/python.md

@@ -0,0 +1,41 @@
+---
+paths:
+  - "src/**"
+  - "tests/**"
+---
+
+# Python Coding Rules
+
+## Style
+- snake_case for functions/variables, PascalCase for classes
+- Type hints required on all function signatures
+- `from __future__ import annotations` at the top of modules using new-style unions on 3.10
+- Google-style docstrings on public functions and Click commands (the docstring is the `--help` text)
+- Target Python 3.10+; keep syntax compatible with 3.10/3.11/3.12
+
+## CLI (Click)
+- Every command is a `@click.command` / `@click.group` with explicit `@click.option` / `@click.argument`
+- User-facing output goes through `click.echo`, formatted via `gw.output.format_output` — never bare `print()`
+- Respect the global `--json` / `--account` flags from `ctx.obj`; pass them into `format_output`
+- Validate user input with `click.BadParameter`, not bare exceptions
+
+## Error Handling
+- Raise `RuntimeError` (or `click.BadParameter` for bad input) with an actionable message; the top-level CLI maps these to friendly errors
+- Never swallow exceptions silently — re-raise or surface a clear message
+- Auth/credential failures must tell the user how to recover (e.g. "Run 'gw auth login'")
+
+## Google API
+- Build services lazily; reuse credentials from the token store
+- Never assume a field exists in an API response — use `.get(...)` with sensible defaults
+- Request only the scopes a command needs
+
+## Security
+- Never commit `credentials.json`, tokens, or `.env` (see `.gitignore`)
+- Never log access/refresh tokens or full credential payloads
+- Store tokens under the config dir with restrictive permissions; never write secrets to `os.environ`
+
+## Testing
+- `pytest`; mock the Google API client (no live network calls in unit tests)
+- Use Click's `CliRunner` for command tests; pass `--config-dir` to isolate state
+- Test error paths (missing account, bad input, API failure), not just the happy path
+- Every changed/added code path needs a test

google_workspace_cli-0.1.0/.claude/rules/versioning.md

@@ -0,0 +1,62 @@
+---
+paths:
+  - "src/gw/__init__.py"
+  - "pyproject.toml"
+  - ".claude-plugin/plugin.json"
+  - ".claude-plugin/marketplace.json"
+---
+
+# Version Management
+
+## Single Source of Truth
+
+- The canonical version is `__version__` in `src/gw/__init__.py`
+- `pyproject.toml` uses `dynamic = ["version"]` with `[tool.hatch.version]` to read it — never set `version = "..."` in `pyproject.toml`
+- The two Claude Code plugin manifests carry their own `version` and must be kept in sync:
+  - `.claude-plugin/plugin.json` → `version`
+  - `.claude-plugin/marketplace.json` → `plugins[0].version`
+- `/release` bumps all three in lockstep
+
+## SemVer Rules
+
+Format: `MAJOR.MINOR.PATCH` (e.g. `0.2.3`)
+
+| Change type | Bump | Example |
+|-------------|------|---------|
+| Breaking change | MAJOR | Removing/renaming a CLI command or flag |
+| New feature (backward compatible) | MINOR | Adding a new `gw` subcommand |
+| Bug fix, docs, refactor | PATCH | Fixing an error message |
+
+While `MAJOR` is `0`, breaking changes bump MINOR instead.
+
+## Conventional Commits → Version
+
+| Commit prefix | Version bump |
+|---------------|-------------|
+| `feat` | MINOR (or PATCH if 0.x) |
+| `fix`, `perf` | PATCH |
+| `BREAKING CHANGE` footer or `!` suffix | MAJOR (or MINOR if 0.x) |
+| `docs`, `chore`, `refactor`, `test`, `ci` | No bump |
+
+## Release Flow
+
+Use `/release patch|minor|major` to:
+1. Bump `__version__` in `src/gw/__init__.py`
+2. Sync `version` in `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json`
+3. `uv lock` and `uv build` (verify)
+4. Commit: `chore(release): vX.Y.Z`
+5. Tag: `vX.Y.Z`
+6. Push commit + tag → the `Publish to PyPI` workflow publishes to PyPI
+
+### Test release
+
+Manual trigger via GitHub Actions → `Publish to PyPI` → Run workflow → `testpypi`
+
+## Release Infrastructure (Trusted Publishing)
+
+Publishing uses PyPI's OIDC Trusted Publisher — **no API tokens**. Configure once:
+
+- **PyPI project**: `google-workspace-cli`
+- **Owner / repo**: `JFK/gw-cli`
+- **Workflow**: `publish.yml`
+- **Environments**: `pypi` (production) and `testpypi` — create both as GitHub Environments and register each as a Trusted Publisher on PyPI / TestPyPI

google_workspace_cli-0.1.0/.claude/settings.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "file_path=$(cat | jq -r '.tool_input.file_path // empty'); [ -z \"$file_path\" ] && exit 0; case \"$file_path\" in *.py) uv run ruff format --quiet \"$file_path\" 2>/dev/null;; esac; exit 0"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "INPUT=$(cat); CMD=$(echo \"$INPUT\" | jq -r '.tool_input.command // empty'); if echo \"$CMD\" | grep -qE 'gh pr (merge|create)'; then echo 'Reminder: Before PR, ensure /quality and /self-review have been run.' >&2; fi; if echo \"$CMD\" | grep -qE 'git tag v'; then echo 'Reminder: Bump the version in src/gw/__init__.py and the .claude-plugin manifests before tagging (use /release).' >&2; fi; exit 0"
+          }
+        ]
+      }
+    ]
+  }
+}

google_workspace_cli-0.1.0/.claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "gw-cli",
+  "description": "Google Workspace CLI for Claude Code — manage Calendar, Gmail, Drive with multi-account support",
+  "owner": {
+    "name": "Fumikazu Kiyota",
+    "email": "fumikazu.kiyota@gmail.com"
+  },
+  "plugins": [
+    {
+      "name": "gw-cli",
+      "source": "./",
+      "version": "0.1.0",
+      "category": "productivity"
+    }
+  ]
+}

google_workspace_cli-0.1.0/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "gw-cli",
+  "version": "0.1.0",
+  "description": "Google Workspace CLI for Claude Code — Calendar, Gmail, Drive with multi-account support",
+  "author": {
+    "name": "Fumikazu Kiyota",
+    "url": "https://github.com/JFK"
+  },
+  "repository": "https://github.com/JFK/gw-cli",
+  "license": "MIT",
+  "keywords": [
+    "google-workspace",
+    "calendar",
+    "gmail",
+    "drive",
+    "multi-account",
+    "oauth",
+    "cli",
+    "productivity"
+  ],
+  "commands": ["./commands/"]
+}

google_workspace_cli-0.1.0/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: JFK

google_workspace_cli-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.10
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Lint
+        run: uv run ruff check src/ tests/
+
+      - name: Format check
+        run: uv run ruff format --check src/ tests/
+
+      - name: Type check
+        run: uv run pyright src/
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --dev --python ${{ matrix.python-version }}
+
+      - name: Test with coverage
+        run: uv run pytest tests/ -v --cov=src/gw --cov-report=xml --cov-report=term

google_workspace_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,97 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      target:
+        description: "Publish target"
+        required: true
+        default: "testpypi"
+        type: choice
+        options:
+          - testpypi
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Build
+        run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    if: github.event_name == 'workflow_dispatch'
+    needs: build
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create GitHub Release
+        # Idempotent + race-safe: the /release skill may also create the release
+        # (with hand-written notes) right after pushing the tag, so a plain
+        # check-then-create here can lose the race and 422 with
+        # "Release.tag_name already exists". Re-check after a failed create and
+        # treat "already exists" as success.
+        run: |
+          if gh release view "$REF" >/dev/null 2>&1; then
+            echo "Release $REF already exists, skipping."
+          elif gh release create "$REF" --generate-notes; then
+            echo "Created release $REF."
+          elif gh release view "$REF" >/dev/null 2>&1; then
+            echo "Release $REF was created concurrently; treating as success."
+          else
+            echo "Failed to create release $REF." >&2
+            exit 1
+          fi
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REF: ${{ github.ref_name }}

google_workspace_cli-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.venv/
+credentials/
+tokens/
+.env
+.env.*
+*.json
+!.claude-plugin/*.json
+!.claude/settings.json
+!pyproject.toml
+.pytest_cache/
+.ruff_cache/
+.coverage
+
+# local OAuth client secret (never commit)
+credentials.json

google_workspace_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to this project are documented here. The format is based on
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- PyPI packaging: published as `google-workspace-cli` via hatchling with the version sourced from
+  `src/gw/__init__.py`.
+- GitHub Actions: `ci.yml` (lint + type check + test on Python 3.10/3.11/3.12) and
+  `publish.yml` (OIDC Trusted Publishing to PyPI/TestPyPI + GitHub Release).
+- Claude Code dev config: `CLAUDE.md`, `.claude/rules/`, and `.claude/commands/`
+  (`/quality`, `/test`, `/self-review`, `/release`).
+- `CONTRIBUTING.md`.
+
+## [0.1.0]
+
+### Added
+- Initial release: multi-account Google Workspace CLI (`gw`) for Calendar, Gmail, and Drive
+  with OAuth, plus a Claude Code plugin with 7 skills.
+
+[Unreleased]: https://github.com/JFK/gw-cli/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/JFK/gw-cli/releases/tag/v0.1.0

google_workspace_cli-0.1.0/CLAUDE.md

@@ -0,0 +1,54 @@
+# gw-cli — Development Guide
+
+## Overview
+
+Google Workspace CLI for Claude Code. A Click-based, synchronous CLI (`gw`) over the Google
+Calendar, Gmail, and Drive APIs with multi-account OAuth. Also ships as a Claude Code plugin.
+
+- **PyPI package**: `google-workspace-cli` (the `gw-cli` name was taken) — import package and command are both `gw`
+- **Plugin**: `.claude-plugin/` + `commands/gw-*.md` (7 skills)
+
+Modules (`src/gw/`):
+- `cli.py` — Click root group, global `--json` / `--account` flags
+- `auth.py` — OAuth login/switch/list/remove, token store
+- `calendar.py`, `gmail.py`, `drive.py` — per-service command groups
+- `config.py` — config dir + account state
+- `output.py` — `format_output` (text/JSON rendering)
+
+## Development Workflow
+
+See `.claude/rules/development-workflow.md` for the full flow (auto-loaded).
+
+**Key sequence**: Issue → Branch → Implement → `/quality` → `/self-review` → PR → Merge
+
+## Commands
+
+```bash
+uv sync --dev                    # Install deps (incl. dev)
+uv run pytest tests/ -v          # Tests
+uv run ruff check src/ tests/    # Lint
+uv run ruff format src/ tests/   # Format
+uv run pyright src/              # Type check
+```
+
+**Slash commands**: `/quality`, `/test`, `/self-review`, `/release patch|minor|major`
+
+## Conventions
+
+- Click commands; user output via `click.echo(format_output(...))`, never bare `print()`
+- Honor global `--json` / `--account` from `ctx.obj`
+- Errors: `RuntimeError` / `click.BadParameter` with an actionable recovery hint
+- Never commit `credentials.json`, tokens, or `.env`; never log tokens
+- Full rules: `.claude/rules/python.md` (auto-loaded)
+
+## Versioning & Release
+
+Version lives in `src/gw/__init__.py` (`pyproject.toml` reads it via `dynamic`). The two
+`.claude-plugin/*.json` manifests carry their own `version` and must stay in sync.
+`/release` bumps all three, tags `vX.Y.Z`, and the `Publish to PyPI` workflow publishes `google-workspace-cli`
+via OIDC Trusted Publishing. See `.claude/rules/versioning.md`.
+
+## Branch Strategy
+
+- Branch from `master` for every issue: `{issue-number}-{type}/{description}`
+- Conventional Commits; squash merge to `master`