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 [email protected] --headless --no-input
# Prints an authorization URL, then polls until the token arrives

3. First query

export [email protected]

# 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 [email protected]
wk gmail search 'newer_than:7d' --json

Full details on OAuth clients and per-domain configuration: docs/auth-clients.md

workit

Popularity

What's Inside

README

workit -- your office, from the terminal.

Why workit?

Install

One Command (recommended)

Update

Quick Start

1. Check auth status

2. Authorize your account

3. First query

1. Create OAuth credentials

2. Store credentials

3. Authorize your account

4. First query

Services

Confidence

Similar Plugins

ecc

security-guidance

everything-claude-code

More by automagik-dev

genie

omni