The article states that agents work better with JSON than documented flags - that seems counterintuitive . How is this assumption validated?
Try building a CLI with a complex JSON as flags approach. :)
Readit Newsjustinwp commented on You need to rewrite your CLI for AI agents justin.poehnelt.com/posts... · Posted by u/justinwp
justinwp commented on You need to rewrite your CLI for AI agents justin.poehnelt.com/posts... · Posted by u/justinwp
Google really know how to screw up a product experience.
npm install -g @googleworkspace/cli
gws auth setup
{ "error": { "code": 400, "message": "gcloud CLI not found. Install it from https://cloud.google.com/sdk/docs/install", "reason": "validationError" } }
Which takes you to...
https://docs.cloud.google.com/sdk/docs/install-sdk
Where you have to download a tarball, extract it and run a shell script.
I mean how hard is it to just imitate everyone else out there and make it a straight up npm install?
You don't need to use gcloud if you already have:
1. A GCP project (needed for OAuth) 2. Enabled APIs in said project
God, getting this set up is frustrating. I've spent 45 minutes trying to get this to work, just following their defaults the whole way through.
Multiple errors and issues along the way, now I'm on `gws auth login`, and trying to pick the oAuth scopes. I go ahead and trust their defaults and select `recommended`, only to get a warning that this is too many scopes and may error out (then why is this the recommended setting??), and then yeah, it errors out when trying to authenticate in the browser.
The error tells me I need to verify my app, so I go to the app settings in my cloud console and try to verify and there's no streamlined way to do this. It seems the intended approach is for me to manually add, one by one, each of the 85 scopes that are on the "recommended" list, and then go through the actual verification.
Have the people that built and released this actually tried to install and run this, just a single time, purely following their own happy path?
There are many gotchas in this process and unfortunately there is no easy way to deal with the OAuth setup.
justinwp commented on You need to rewrite your CLI for AI agents justin.poehnelt.com/posts... · Posted by u/justinwp
Title is a little clickbait, but not really! :)
---
Human DX optimizes for discoverability and forgiveness. Agent DX optimizes for predictability and defense-in-depth. These are different enough that retrofitting a human-first CLI for agents is a losing bet.
Drive, Gmail, Calendar, and every Workspace API. Structured JSON output. 40+ agent skills included.