docs(site): add gogcli.sh landing page

This commit is contained in:
Peter Steinberger 2025-12-26 21:17:32 +01:00
parent 9c255b4a9a
commit fa246dac39
5 changed files with 1064 additions and 1 deletions

View File

@ -1 +1 @@
gogcli.sh
gogcli.sh

489
docs/assets/site.css Normal file
View File

@ -0,0 +1,489 @@
:root {
--bg0: #07070b;
--bg1: #0b0b11;
--bg2: #11111a;
--card: rgba(17, 17, 26, 0.72);
--card2: rgba(12, 12, 18, 0.64);
--stroke: rgba(255, 255, 255, 0.08);
--stroke2: rgba(255, 255, 255, 0.05);
--text: #f3f4f6;
--muted: rgba(243, 244, 246, 0.7);
--dim: rgba(243, 244, 246, 0.46);
--b: #4285f4;
--r: #ea4335;
--y: #fbbc05;
--g: #34a853;
--shadow: 0 24px 60px rgba(0, 0, 0, 0.55);
--shadow2: 0 16px 40px rgba(0, 0, 0, 0.45);
--radius: 16px;
--radius2: 22px;
--serif: "Fraunces", ui-serif, Georgia, serif;
--sans: "DM Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
--mono: "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
}
* {
box-sizing: border-box;
}
html,
body {
height: 100%;
}
body {
margin: 0;
background: radial-gradient(1200px 800px at 50% -20%, rgba(66, 133, 244, 0.18), transparent 60%),
radial-gradient(900px 700px at 80% 18%, rgba(234, 67, 53, 0.14), transparent 55%),
radial-gradient(1000px 900px at 18% 62%, rgba(52, 168, 83, 0.14), transparent 55%),
radial-gradient(900px 900px at 65% 88%, rgba(251, 188, 5, 0.12), transparent 55%),
linear-gradient(180deg, var(--bg0), var(--bg1) 40%, var(--bg0));
color: var(--text);
font-family: var(--sans);
-webkit-font-smoothing: antialiased;
line-height: 1.55;
overflow-x: hidden;
}
a {
color: inherit;
text-decoration: none;
}
a:hover {
text-decoration: underline;
}
code {
font-family: var(--mono);
font-size: 0.95em;
}
.skip {
position: absolute;
left: -999px;
top: 10px;
background: var(--bg2);
border: 1px solid var(--stroke);
color: var(--text);
padding: 10px 12px;
border-radius: 10px;
z-index: 20;
}
.skip:focus {
left: 12px;
}
.bg {
position: fixed;
inset: 0;
pointer-events: none;
z-index: 0;
}
.bg__mesh {
position: absolute;
inset: 0;
background: radial-gradient(1200px 800px at 20% 20%, rgba(66, 133, 244, 0.18), transparent 60%),
radial-gradient(1000px 800px at 82% 30%, rgba(234, 67, 53, 0.12), transparent 55%),
radial-gradient(1000px 900px at 40% 85%, rgba(52, 168, 83, 0.12), transparent 55%);
filter: blur(4px) saturate(1.12);
opacity: 0.95;
}
.bg__grid {
position: absolute;
inset: -2px;
background-image: linear-gradient(rgba(255, 255, 255, 0.04) 1px, transparent 1px),
linear-gradient(90deg, rgba(255, 255, 255, 0.04) 1px, transparent 1px);
background-size: 72px 72px;
opacity: 0.055;
transform: perspective(900px) rotateX(58deg) translateY(-18%);
transform-origin: top;
mask-image: radial-gradient(60% 60% at 50% 30%, rgba(0, 0, 0, 1), transparent 72%);
}
.bg__grain {
position: absolute;
inset: 0;
opacity: 0.2;
background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='240'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.8' numOctaves='3' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='240' height='240' filter='url(%23n)' opacity='.45'/%3E%3C/svg%3E");
mix-blend-mode: overlay;
}
.wrap {
width: min(1100px, calc(100% - 48px));
margin: 0 auto;
position: relative;
z-index: 1;
}
.top {
position: sticky;
top: 0;
z-index: 10;
backdrop-filter: blur(12px);
-webkit-backdrop-filter: blur(12px);
background: rgba(7, 7, 11, 0.58);
border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}
.top__row {
display: flex;
align-items: center;
justify-content: space-between;
padding: 14px 0;
}
.brand {
display: flex;
align-items: center;
gap: 10px;
text-decoration: none !important;
}
.brand__mark {
width: 26px;
height: 26px;
border-radius: 10px;
background: conic-gradient(from 200deg, var(--b), var(--g), var(--y), var(--r), var(--b));
box-shadow: 0 10px 24px rgba(66, 133, 244, 0.15), 0 10px 24px rgba(52, 168, 83, 0.12);
}
.brand__mark--small {
width: 18px;
height: 18px;
border-radius: 7px;
}
.brand__name {
font-family: var(--mono);
font-weight: 500;
letter-spacing: -0.02em;
}
.brand__tag {
font-size: 12px;
color: var(--dim);
border: 1px solid var(--stroke2);
background: rgba(17, 17, 26, 0.55);
padding: 3px 8px;
border-radius: 999px;
}
.nav {
display: flex;
align-items: center;
gap: 18px;
font-size: 14px;
color: var(--muted);
}
.nav a {
text-decoration: none;
}
.nav a:hover {
color: var(--text);
text-decoration: none;
}
.nav__cta {
color: var(--text) !important;
background: rgba(255, 255, 255, 0.06);
border: 1px solid rgba(255, 255, 255, 0.08);
padding: 8px 12px;
border-radius: 999px;
}
.main {
padding-bottom: 70px;
}
.hero {
padding: 56px 0 26px;
}
.hero__grid {
display: grid;
grid-template-columns: 1.05fr 0.95fr;
gap: 28px;
align-items: start;
}
.kicker {
display: inline-flex;
gap: 10px;
align-items: center;
font-size: 12px;
letter-spacing: 0.12em;
text-transform: uppercase;
color: rgba(243, 244, 246, 0.58);
margin: 0 0 14px;
}
.kicker::before {
content: "";
width: 10px;
height: 10px;
border-radius: 3px;
background: linear-gradient(135deg, rgba(66, 133, 244, 0.9), rgba(52, 168, 83, 0.85));
box-shadow: 0 0 0 4px rgba(66, 133, 244, 0.08);
}
h1 {
font-family: var(--serif);
font-weight: 700;
letter-spacing: -0.03em;
line-height: 0.95;
margin: 0 0 14px;
font-size: clamp(44px, 5.5vw, 68px);
}
.hero__word {
display: block;
opacity: 0;
transform: translateY(10px);
animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) forwards;
}
.hero__word:nth-child(1) {
animation-delay: 80ms;
}
.hero__word:nth-child(2) {
animation-delay: 160ms;
}
.hero__word:nth-child(3) {
animation-delay: 260ms;
}
.hero__word--mono {
font-family: var(--mono);
font-weight: 500;
letter-spacing: -0.04em;
color: rgba(243, 244, 246, 0.92);
}
@keyframes rise {
to {
opacity: 1;
transform: translateY(0);
}
}
.lede {
margin: 0 0 18px;
font-size: 16.5px;
color: var(--muted);
max-width: 52ch;
opacity: 0;
transform: translateY(10px);
animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 320ms forwards;
}
.lede strong {
color: var(--text);
font-weight: 600;
}
.pills {
display: flex;
flex-wrap: wrap;
gap: 8px;
margin: 0 0 20px;
opacity: 0;
transform: translateY(10px);
animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 380ms forwards;
}
.pill {
font-size: 12px;
border-radius: 999px;
padding: 6px 10px;
border: 1px solid var(--stroke2);
background: rgba(17, 17, 26, 0.55);
color: rgba(243, 244, 246, 0.76);
}
.pill--b {
box-shadow: inset 0 0 0 1px rgba(66, 133, 244, 0.25);
}
.pill--r {
box-shadow: inset 0 0 0 1px rgba(234, 67, 53, 0.22);
}
.pill--y {
box-shadow: inset 0 0 0 1px rgba(251, 188, 5, 0.22);
}
.pill--g {
box-shadow: inset 0 0 0 1px rgba(52, 168, 83, 0.22);
}
.hero__actions {
display: flex;
gap: 12px;
margin: 0 0 12px;
opacity: 0;
transform: translateY(10px);
animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 440ms forwards;
}
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
gap: 10px;
padding: 10px 14px;
border-radius: 999px;
border: 1px solid rgba(255, 255, 255, 0.08);
text-decoration: none !important;
font-weight: 600;
font-size: 14px;
box-shadow: 0 10px 24px rgba(0, 0, 0, 0.22);
}
.btn--primary {
background: linear-gradient(135deg, rgba(66, 133, 244, 0.92), rgba(52, 168, 83, 0.86));
color: #091018;
border-color: rgba(255, 255, 255, 0.12);
box-shadow: 0 18px 44px rgba(66, 133, 244, 0.18), 0 18px 44px rgba(52, 168, 83, 0.14);
}
.btn--ghost {
background: rgba(255, 255, 255, 0.06);
color: var(--text);
}
.btn:hover {
transform: translateY(-1px);
}
.note {
margin: 0;
color: rgba(243, 244, 246, 0.56);
font-size: 13px;
opacity: 0;
transform: translateY(10px);
animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 520ms forwards;
}
.note code {
background: rgba(255, 255, 255, 0.06);
border: 1px solid rgba(255, 255, 255, 0.07);
padding: 2px 6px;
border-radius: 8px;
color: rgba(243, 244, 246, 0.84);
}
.hero__panel {
display: grid;
gap: 14px;
opacity: 0;
transform: translateY(10px);
animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 260ms forwards;
}
.card {
border: 1px solid var(--stroke);
background: var(--card);
border-radius: var(--radius2);
box-shadow: var(--shadow);
overflow: hidden;
}
.term__bar {
display: flex;
align-items: center;
gap: 12px;
padding: 12px 14px;
background: rgba(12, 12, 18, 0.58);
border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}
.dots {
display: inline-flex;
gap: 6px;
}
.dot {
width: 11px;
height: 11px;
border-radius: 999px;
}
.dot--r {
background: #ff5f57;
}
.dot--y {
background: #febc2e;
}
.dot--g {
background: #28c840;
}
.term__title {
margin-left: auto;
margin-right: auto;
font-family: var(--mono);
font-size: 12px;
color: rgba(243, 244, 246, 0.55);
}
.term__body {
padding: 14px 14px 16px;
background: rgba(11, 11, 17, 0.6);
}
.term__pre {
margin: 0;
font-family: var(--mono);
font-size: 12.5px;
color: rgba(243, 244, 246, 0.86);
line-height: 1.6;
white-space: pre-wrap;
}
.term__pre code {
display: block;
}
.meta {
padding: 14px 14px;
background: var(--card2);
border: 1px solid rgba(255, 255, 255, 0.06);
box-shadow: var(--shadow2);
}
.meta__item {
display: grid;
grid-template-columns: 90px 1fr;
gap: 12px;
padding: 10px 0;
}
.meta__item + .meta__item {
border-top: 1px solid rgba(255, 255, 255, 0.06);
}
.meta__k {
color: rgba(243, 244, 246, 0.55);
font-size: 12px;
letter-spacing: 0.06em;
text-transform: uppercase;
}
.meta__v {
color: rgba(243, 244, 246, 0.86);
font-size: 13px;
}
.meta__v code {
background: rgba(255, 255, 255, 0.06);
border: 1px solid rgba(255, 255, 255, 0.07);
padding: 2px 6px;
border-radius: 8px;
color: rgba(243, 244, 246, 0.9);
}

34
docs/assets/site.js Normal file
View File

@ -0,0 +1,34 @@
(() => {
const el = document.getElementById("demo");
if (!el) return;
const original = el.textContent || "";
const prefersReduced = window.matchMedia?.("(prefers-reduced-motion: reduce)")?.matches;
if (prefersReduced) return;
el.textContent = "";
const lines = original.split("\n");
const chunkDelay = 16;
const lineDelay = 140;
let i = 0;
let j = 0;
const tick = () => {
if (i >= lines.length) return;
const line = lines[i];
if (j <= line.length) {
el.textContent += line.slice(j, j + 1);
j += 1;
window.setTimeout(tick, chunkDelay);
return;
}
el.textContent += "\n";
i += 1;
j = 0;
window.setTimeout(tick, lineDelay);
};
window.setTimeout(tick, 260);
})();

239
docs/assets/site.more.css Normal file
View File

@ -0,0 +1,239 @@
.section {
padding: 52px 0;
}
.section__grid {
display: grid;
grid-template-columns: 0.36fr 0.64fr;
gap: 28px;
align-items: start;
}
h2 {
font-family: var(--serif);
font-weight: 700;
letter-spacing: -0.02em;
margin: 0 0 6px;
font-size: 28px;
}
h3 {
margin: 0 0 8px;
font-size: 16px;
font-weight: 700;
}
.muted {
margin: 0;
color: var(--muted);
}
.cols {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 14px;
}
.block {
padding: 16px 16px;
}
.code {
margin: 0;
padding: 12px 12px;
border-radius: 14px;
background: rgba(0, 0, 0, 0.22);
border: 1px solid rgba(255, 255, 255, 0.08);
overflow: auto;
}
.code code {
font-family: var(--mono);
font-size: 12.5px;
color: rgba(243, 244, 246, 0.88);
}
.steps {
display: grid;
gap: 14px;
}
.step {
display: grid;
grid-template-columns: 46px 1fr;
gap: 14px;
padding: 16px;
border-radius: var(--radius2);
border: 1px solid rgba(255, 255, 255, 0.08);
background: rgba(12, 12, 18, 0.46);
box-shadow: var(--shadow2);
}
.step__n {
width: 40px;
height: 40px;
border-radius: 14px;
display: grid;
place-items: center;
font-family: var(--mono);
font-weight: 500;
color: rgba(243, 244, 246, 0.92);
background: linear-gradient(135deg, rgba(66, 133, 244, 0.22), rgba(52, 168, 83, 0.18));
border: 1px solid rgba(255, 255, 255, 0.08);
}
.step p {
margin: 0 0 10px;
color: var(--muted);
}
.callout {
margin-top: 14px;
display: grid;
grid-template-columns: 44px 1fr;
gap: 14px;
padding: 16px;
border-radius: var(--radius2);
border: 1px solid rgba(255, 255, 255, 0.08);
background: linear-gradient(135deg, rgba(66, 133, 244, 0.14), rgba(234, 67, 53, 0.08));
box-shadow: var(--shadow2);
}
.callout__icon {
width: 44px;
height: 44px;
border-radius: 16px;
background: rgba(0, 0, 0, 0.18);
border: 1px solid rgba(255, 255, 255, 0.1);
box-shadow: inset 0 0 0 1px rgba(66, 133, 244, 0.18);
}
.callout__body p {
margin: 0 0 10px;
color: var(--muted);
}
.callout__body code {
background: rgba(255, 255, 255, 0.06);
border: 1px solid rgba(255, 255, 255, 0.07);
padding: 2px 6px;
border-radius: 8px;
color: rgba(243, 244, 246, 0.92);
}
.grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 14px;
}
.feat {
padding: 16px;
background: rgba(12, 12, 18, 0.46);
box-shadow: var(--shadow2);
}
.feat p {
margin: 0;
color: var(--muted);
}
.footerline {
display: flex;
gap: 12px;
margin-top: 18px;
}
.sitefoot {
padding: 36px 0 26px;
border-top: 1px solid rgba(255, 255, 255, 0.08);
background: rgba(7, 7, 11, 0.35);
backdrop-filter: blur(10px);
-webkit-backdrop-filter: blur(10px);
}
.sitefoot__row {
display: flex;
align-items: center;
justify-content: space-between;
gap: 14px;
}
.sitefoot__brand {
display: inline-flex;
align-items: center;
gap: 10px;
font-family: var(--mono);
}
.sitefoot__small {
margin-top: 8px;
color: rgba(243, 244, 246, 0.6);
font-size: 13px;
}
.sitefoot__small a {
color: rgba(243, 244, 246, 0.75);
}
.sep {
margin: 0 8px;
color: rgba(243, 244, 246, 0.28);
}
.sitefoot__right {
display: flex;
gap: 14px;
color: rgba(243, 244, 246, 0.7);
font-size: 14px;
}
.sitefoot__fineprint {
margin-top: 18px;
color: rgba(243, 244, 246, 0.46);
font-size: 12px;
}
@media (max-width: 980px) {
.hero__grid {
grid-template-columns: 1fr;
}
.section__grid {
grid-template-columns: 1fr;
}
.grid {
grid-template-columns: 1fr 1fr;
}
}
@media (max-width: 640px) {
.wrap {
width: min(1100px, calc(100% - 28px));
}
.nav {
display: none;
}
.cols {
grid-template-columns: 1fr;
}
.grid {
grid-template-columns: 1fr;
}
.footerline {
flex-direction: column;
align-items: flex-start;
}
.sitefoot__row {
flex-direction: column;
align-items: flex-start;
}
}
@media (prefers-reduced-motion: reduce) {
* {
animation: none !important;
transition: none !important;
scroll-behavior: auto !important;
}
}

301
docs/index.html Normal file
View File

@ -0,0 +1,301 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>gog — Google in your terminal</title>
<meta
name="description"
content="gog: a single CLI for Gmail, Calendar, Drive, Contacts, Tasks, Sheets, Docs, Slides, and People."
/>
<meta name="theme-color" content="#0b0b11" />
<meta property="og:title" content="gog — Google in your terminal" />
<meta
property="og:description"
content="One CLI for Gmail, Calendar, Drive, Contacts, Tasks, Sheets, Docs, Slides, and People."
/>
<meta property="og:type" content="website" />
<meta property="og:url" content="https://gogcli.sh/" />
<meta name="twitter:card" content="summary_large_image" />
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link
href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,500;9..144,700&family=DM+Sans:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap"
rel="stylesheet"
/>
<link rel="stylesheet" href="./assets/site.css" />
<link rel="stylesheet" href="./assets/site.more.css" />
</head>
<body>
<a class="skip" href="#main">Skip to content</a>
<div class="bg" aria-hidden="true">
<div class="bg__mesh"></div>
<div class="bg__grid"></div>
<div class="bg__grain"></div>
</div>
<header class="top">
<div class="wrap top__row">
<a class="brand" href="/">
<span class="brand__mark" aria-hidden="true"></span>
<span class="brand__name">gog</span>
<span class="brand__tag">gogcli</span>
</a>
<nav class="nav">
<a href="#install">Install</a>
<a href="#quickstart">Quickstart</a>
<a href="#features">Features</a>
<a href="#examples">Examples</a>
<a class="nav__cta" href="https://github.com/steipete/gogcli">GitHub</a>
</nav>
</div>
</header>
<main id="main" class="main">
<section class="hero">
<div class="wrap hero__grid">
<div class="hero__copy">
<p class="kicker">Google Workspace. One binary.</p>
<h1>
<span class="hero__word">Google</span>
<span class="hero__word">in your</span>
<span class="hero__word hero__word--mono">terminal</span>
</h1>
<p class="lede">
<strong>gog</strong> unifies Gmail, Calendar, Drive, Contacts, Tasks, Sheets, Docs, Slides, and People
under one CLI — with JSON output and sane defaults.
</p>
<div class="pills" aria-label="Supported services">
<span class="pill pill--b">Gmail</span>
<span class="pill pill--g">Calendar</span>
<span class="pill pill--r">Drive</span>
<span class="pill pill--y">Contacts</span>
<span class="pill pill--g">Tasks</span>
<span class="pill pill--g">Sheets</span>
<span class="pill pill--b">Docs</span>
<span class="pill pill--r">Slides</span>
<span class="pill pill--y">People</span>
</div>
<div class="hero__actions">
<a class="btn btn--primary" href="#install">Install</a>
<a class="btn btn--ghost" href="https://github.com/steipete/gogcli#quick-start">Readme</a>
</div>
<p class="note">
Tip: add <code>export GOG_ACCOUNT=you@gmail.com</code> once, stop repeating <code>--account</code>.
</p>
</div>
<div class="hero__panel">
<div class="card term" role="region" aria-label="Terminal demo">
<div class="term__bar" aria-hidden="true">
<span class="dots">
<span class="dot dot--r"></span>
<span class="dot dot--y"></span>
<span class="dot dot--g"></span>
</span>
<span class="term__title">gogcli.sh</span>
</div>
<div class="term__body">
<pre class="term__pre"><code id="demo">
$ brew install steipete/tap/gogcli
$ gog auth credentials ~/Downloads/client_secret.json
$ gog auth add you@gmail.com
$ export GOG_ACCOUNT=you@gmail.com
$ gog gmail labels list
$ gog calendar calendars --max 5 --json | jq '.calendars[].summary'
$ gog drive ls --query "mimeType='application/pdf'" --max 3
</code></pre>
</div>
</div>
<div class="card meta">
<div class="meta__item">
<div class="meta__k">Output</div>
<div class="meta__v">tables / <code>--plain</code> / <code>--json</code></div>
</div>
<div class="meta__item">
<div class="meta__k">Accounts</div>
<div class="meta__v">multi-account + <code>gog auth manage</code></div>
</div>
<div class="meta__item">
<div class="meta__k">Secrets</div>
<div class="meta__v">OS keyring (Keychain / Secret Service / CredMan)</div>
</div>
</div>
</div>
</div>
</section>
<section id="install" class="section">
<div class="wrap section__grid">
<div>
<h2>Install</h2>
<p class="muted">Homebrew tap, or build from source.</p>
</div>
<div class="cols">
<div class="card block">
<h3>Homebrew</h3>
<pre class="code"><code>brew install steipete/tap/gogcli</code></pre>
</div>
<div class="card block">
<h3>From source</h3>
<pre class="code"><code>git clone https://github.com/steipete/gogcli.git
cd gogcli
make
./bin/gog --help</code></pre>
</div>
</div>
</div>
</section>
<section id="quickstart" class="section">
<div class="wrap section__grid">
<div>
<h2>Quickstart</h2>
<p class="muted">
Youll need a Google Cloud “Desktop app” OAuth client JSON once. Then you can keep adding accounts.
</p>
</div>
<div class="steps">
<div class="step">
<div class="step__n">1</div>
<div class="step__b">
<h3>Store credentials</h3>
<p>Save your downloaded client JSON into gogs config.</p>
<pre class="code"><code>gog auth credentials ~/Downloads/client_secret_....json</code></pre>
</div>
</div>
<div class="step">
<div class="step__n">2</div>
<div class="step__b">
<h3>Authorize an account</h3>
<p>Browser flow by default. Use <code>--manual</code> for headless.</p>
<pre class="code"><code>gog auth add you@gmail.com</code></pre>
</div>
</div>
<div class="step">
<div class="step__n">3</div>
<div class="step__b">
<h3>Run commands</h3>
<p>Use <code>--json</code> for scripting.</p>
<pre class="code"><code>export GOG_ACCOUNT=you@gmail.com
gog gmail search 'newer_than:7d' --max 10 --json | jq</code></pre>
</div>
</div>
</div>
<div class="callout">
<div class="callout__icon" aria-hidden="true"></div>
<div class="callout__body">
<h3>Re-auth a service (e.g. Sheets)</h3>
<p>
If you add scopes later and Google doesnt return a refresh token, re-run with
<code>--force-consent</code>.
</p>
<pre class="code"><code>gog auth add you@gmail.com --services sheets --force-consent</code></pre>
</div>
</div>
</div>
</section>
<section id="features" class="section">
<div class="wrap section__grid">
<div>
<h2>Features</h2>
<p class="muted">High leverage commands, consistent UX, and clean output.</p>
</div>
<div class="grid">
<div class="card feat">
<h3>Gmail</h3>
<p>Search threads, send mail, manage labels, drafts, filters, settings, and watch (Pub/Sub push).</p>
</div>
<div class="card feat">
<h3>Calendar</h3>
<p>List/create/update events, respond to invites, detect conflicts, and check free/busy.</p>
</div>
<div class="card feat">
<h3>Drive</h3>
<p>List/search/upload/download, export Docs formats, permissions, folders, URLs.</p>
</div>
<div class="card feat">
<h3>Sheets / Docs / Slides</h3>
<p>Read/write Sheets; export Docs/Slides/Sheets to PDF/DOCX/PPTX/XLSX/CSV via Drive.</p>
</div>
<div class="card feat">
<h3>Contacts / People</h3>
<p>Personal contacts, “other contacts”, Workspace directory, and your profile.</p>
</div>
<div class="card feat">
<h3>Tasks</h3>
<p>Tasklists + tasks: add/update/done/undo/delete/clear with paging and JSON output.</p>
</div>
</div>
</div>
</section>
<section id="examples" class="section">
<div class="wrap section__grid">
<div>
<h2>Examples</h2>
<p class="muted">A few commands youll actually use.</p>
</div>
<div class="cols">
<div class="card block">
<h3>Find unread mail</h3>
<pre class="code"><code>gog gmail search 'is:unread newer_than:7d' --max 20</code></pre>
<p class="muted">Pipe JSON to jq for scripts.</p>
<pre class="code"><code>gog gmail search 'newer_than:7d' --max 50 --json | jq '.threads[] | .subject'</code></pre>
</div>
<div class="card block">
<h3>Export a Sheet as PDF</h3>
<pre class="code"><code>gog sheets export &lt;spreadsheetId&gt; --format pdf --out ./sheet.pdf</code></pre>
<p class="muted">Docs and Slides are similar.</p>
<pre class="code"><code>gog docs export &lt;docId&gt; --format docx --out ./doc.docx
gog slides export &lt;presentationId&gt; --format pptx --out ./deck.pptx</code></pre>
</div>
</div>
<div class="footerline">
<a class="btn btn--primary" href="https://github.com/steipete/gogcli">Go to GitHub</a>
<a class="btn btn--ghost" href="https://github.com/steipete/gogcli/blob/main/CHANGELOG.md">Changelog</a>
</div>
</div>
</section>
</main>
<footer class="sitefoot">
<div class="wrap sitefoot__row">
<div class="sitefoot__left">
<div class="sitefoot__brand">
<span class="brand__mark brand__mark--small" aria-hidden="true"></span>
<span>gog</span>
</div>
<div class="sitefoot__small">
<span>Built by Peter Steinberger.</span>
<span class="sep" aria-hidden="true">·</span>
<a href="https://github.com/steipete/gogcli/blob/main/LICENSE">MIT</a>
</div>
</div>
<div class="sitefoot__right">
<a href="https://github.com/steipete/gogcli">Source</a>
<a href="https://github.com/steipete/gogcli#installation">Install</a>
<a href="https://github.com/steipete/gogcli#commands">Commands</a>
</div>
</div>
<div class="wrap sitefoot__fineprint">
<span>Not affiliated with Google. Google is a trademark of Google LLC.</span>
</div>
</footer>
<script src="./assets/site.js"></script>
</body>
</html>