fix(docs): improve README typography and spacing (#14)

* fix(docs): improve README typography and spacing

- Remove center alignment for tagline and badges to match left-aligned body
- Add `<br>` after badges for visual separation before install block
- Increase whitespace above install block to emphasize it
- Add an empty line above `> [!IMPORTANT]` block to decouple it from previous paragraph

Co-authored-by: jpoehnelt <3392975+jpoehnelt@users.noreply.github.com>

* Update README.md

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* docs: improve README typography and layout

- Remove center alignment from tagline and badges
- Add space below badges
- Adjust spacing around install code block (remove borders, add empty line above)
- Add empty line above IMPORTANT callout

Co-authored-by: jpoehnelt <3392975+jpoehnelt@users.noreply.github.com>

* docs: refine copy after install code block

- Change "When Google adds an API endpoint" to "When Google Workspace adds an API endpoint or method" to be more accurate.

Co-authored-by: jpoehnelt <3392975+jpoehnelt@users.noreply.github.com>

* docs: remove horizontal borders from README

Per user request, removed all remaining Markdown horizontal rules (`---`) throughout `README.md` to create a cleaner, borderless design. All previous typography and spacing improvements remain intact.

Co-authored-by: jpoehnelt <3392975+jpoehnelt@users.noreply.github.com>

---------

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: jpoehnelt <3392975+jpoehnelt@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
This commit is contained in:
Justin Poehnelt
2026-03-03 13:53:14 -07:00
committed by GitHub
parent d93a621a74
commit d29f41ecf7
2 changed files with 10 additions and 15 deletions
+5
View File
@@ -0,0 +1,5 @@
---
"@googleworkspace/cli": patch
---
Fix README typography and spacing
+5 -15
View File
@@ -4,27 +4,24 @@
<h1 align="center">gws</h1>
<p align="center">
<strong>One CLI for all of Google Workspace built for humans and AI agents.</strong><br>
Drive, Gmail, Calendar, and every Workspace API. Zero boilerplate. Structured JSON output. 40+ agent skills included.
</p>
**One CLI for all of Google Workspace — built for humans and AI agents.**<br>
Drive, Gmail, Calendar, and every Workspace API. Zero boilerplate. Structured JSON output. 40+ agent skills included.
<p align="center">
<p>
<a href="https://www.npmjs.com/package/@googleworkspace/cli"><img src="https://img.shields.io/npm/v/@googleworkspace/cli" alt="npm version"></a>
<a href="https://github.com/googleworkspace/cli/blob/main/LICENSE"><img src="https://img.shields.io/github/license/googleworkspace/cli" alt="license"></a>
<a href="https://github.com/googleworkspace/cli/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/googleworkspace/cli/ci.yml?branch=main&label=CI" alt="CI status"></a>
<a href="https://www.npmjs.com/package/@googleworkspace/cli"><img src="https://img.shields.io/npm/unpacked-size/@googleworkspace/cli" alt="install size"></a>
</p>
<br>
---
```bash
npm install -g @googleworkspace/cli
```
---
`gws` doesn't ship a static list of commands. It reads Google's own [Discovery Service](https://developers.google.com/discovery) at runtime and builds its entire command surface dynamically. When Google Workspace adds an API endpoint or method, `gws` picks it up automatically.
`gws` doesn't ship a static list of commands. It reads Google's own [Discovery Service](https://developers.google.com/discovery) at runtime and builds its entire command surface dynamically. When Google adds an API endpoint, `gws` picks it up automatically.
> [!IMPORTANT]
> This project is under active development. Expect breaking changes as we march toward v1.0.
@@ -58,7 +55,6 @@ Or build from source:
cargo install --path .
```
---
## Why gws?
@@ -86,7 +82,6 @@ gws schema drive.files.list
gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name'
```
---
## Authentication
@@ -150,7 +145,6 @@ export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)
Environment variables can also live in a `.env` file.
---
## AI Agent Skills
@@ -180,7 +174,6 @@ The `gws-shared` skill includes an `install` block so OpenClaw auto-installs the
</details>
---
## Advanced Usage
@@ -212,7 +205,6 @@ gws gmail users messages get --params '...' \
| `GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE` | Default Model Armor template |
| `GOOGLE_WORKSPACE_CLI_SANITIZE_MODE` | `warn` (default) or `block` |
---
## Architecture
@@ -226,7 +218,6 @@ gws gmail users messages get --params '...' \
All output — success, errors, download metadata — is structured JSON.
---
## Development
@@ -237,7 +228,6 @@ cargo test # unit tests
./scripts/coverage.sh # HTML coverage report → target/llvm-cov/html/
```
---
## License