workit -- your office, from the terminal.
Agent-native CLI for Google Workspace. 18+ services, headless OAuth, local DOCX editing, JSON-first output — one binary.
Install ·
Quick Start ·
Services ·
Agent Features ·
DOCX Editing ·
Skills ·
Docs
Why workit?
| |
|---|
| Agent-native | JSON-first output, field discovery (--select ""), input templates (--generate-input), predictable exit codes |
| No GCP setup | Auth relay at auth.automagik.dev — works out of the box, no Google Cloud Console required |
| Headless OAuth | Authorize on any device, run on any server — no tunnels, no browser required on the server |
| 18+ services | Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat, DOCX editing and more — one binary |
| Agent safety | --read-only, --dry-run, --command-tier, --enable-commands sandboxing |
| Multi-account | Named aliases, multiple OAuth clients, per-domain configuration |
| Least-privilege | Per-service scopes, runtime read-only flag, file-only Drive scope |
Install
One Command (recommended)
curl -sSL https://raw.githubusercontent.com/automagik-dev/workit/main/install.sh | sh
This installs:
- The
wk binary to ~/.local/bin/wk
- The Claude Code plugin (28 skill files) to
~/.workit/plugin/ with a symlink at ~/.claude/plugins/workit
The release also includes gog, a git operations companion tool, installed alongside wk.
Update
wk update
See INSTALL.md for detailed install options.
Build from source
Requires Go 1.21+.
git clone https://github.com/automagik-dev/workit.git
cd workit
make build
./bin/wk --help
Quick Start
No Google Cloud Console setup needed. The auth relay handles OAuth for you.
1. Check auth status
wk auth status
2. Authorize your account
wk auth manage
This opens the account manager UI. On headless or remote servers it prints a URL — open it on any device to complete authorization. See docs/headless-auth.md.
For fully non-interactive agent environments:
wk auth add user@example.com --headless --no-input
# Prints an authorization URL, then polls until the token arrives
3. First query
export WK_ACCOUNT=you@gmail.com
# Search recent emails
wk gmail search 'newer_than:7d' --json --select "id,snippet"
# List Drive files
wk drive ls --json --select "name,id,mimeType"
# Edit a local DOCX (no auth needed)
wk docx cat report.docx
wk docx replace report.docx "DRAFT" "FINAL" -o report.docx
Quick Start -- BYO GCP (bring your own OAuth client)
For users who want to use their own Google Cloud project and OAuth client instead of the shared relay:
1. Create OAuth credentials
In Google Cloud Console, create a Desktop app OAuth client and download the JSON file.
2. Store credentials
wk auth credentials ~/Downloads/client_secret_....json
3. Authorize your account
wk auth manage
4. First query
export WK_ACCOUNT=you@gmail.com
wk gmail search 'newer_than:7d' --json
Full details on OAuth clients and per-domain configuration: docs/auth-clients.md
Services
