Skip to content

docs(readme): sync configuration and subcommand reference with implementation#38

Merged
appleboy merged 5 commits intomainfrom
worktree-docs
May 5, 2026
Merged

docs(readme): sync configuration and subcommand reference with implementation#38
appleboy merged 5 commits intomainfrom
worktree-docs

Conversation

@appleboy
Copy link
Copy Markdown
Member

Summary

  • Aligns README and `.env.example` with the current CLI implementation: `SCOPE` default is `email profile`, the device authorization endpoint is `/oauth/device/code`, and the token lifecycle now resolves endpoints via OIDC Discovery and fetches UserInfo in parallel with token verification.
  • Documents the timeout / response-body-size environment variables and matching flags introduced alongside OIDC discovery and token revocation.
  • Adds a dedicated Token Subcommands section covering `token get` (`--json`), `token inspect`, `token decode` (`--field`), and `token delete` (`--local-only`, RFC 7009 revocation); previously only `token inspect` was mentioned in passing.

Test plan

  • `make lint` passes (no code changes, docs-only)
  • Visual review of the rendered README on GitHub: TOC links, mermaid diagrams, env-vars / timeouts / flags tables, Token Subcommands section
  • Spot-check that `.env.example` matches the in-code defaults

🤖 Generated with Claude Code

…entation

- Correct SCOPE default to email profile in env vars and .env.example
- Document timeout and response-body-size environment variables and flags
- Update token lifecycle to reference OIDC Discovery and parallel UserInfo
- Fix device authorization endpoint reference to /oauth/device/code
- Add Token Subcommands section covering get, inspect, decode, and delete
- Note that --version is also exposed as a version subcommand
Copilot AI review requested due to automatic review settings April 26, 2026 06:42
@codecov-commenter
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates documentation to match the current authgate-cli behavior and configuration surface area, including endpoint discovery, new timeout/limit knobs, and the expanded token utility subcommands.

Changes:

  • Syncs README flow descriptions and diagrams with current endpoints and OIDC Discovery behavior (including parallel token verification + UserInfo fetch).
  • Documents timeout/limit environment variables and corresponding CLI flags.
  • Adds a dedicated “Token Subcommands” section and updates .env.example scope defaults.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
README.md Updates configuration defaults, documents new timeout/limit controls, and adds/expands token subcommand reference.
.env.example Updates the default SCOPE example to match current CLI defaults.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
- Replace inaccurate POST description with HTTP GET and Authorization Bearer header for token inspect
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
- Note UserInfo and revocation endpoints come from OIDC Discovery and treat the hardcoded paths as defaults
- Clarify that the configurable timeouts cover OAuth flow steps and that the auto-refresh demo reuses the parent context
- Tighten MAX_RESPONSE_BODY_SIZE description to reflect parsed responses and call out the fixed 4 KiB revocation drain
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread README.md Outdated
- Note refresh token revocation only runs when a refresh token is present
- Distinguish duration parsing from MAX_RESPONSE_BODY_SIZE byte parsing in the timeouts intro
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
- Reword the post-auth step to note verification and UserInfo fetch run after any selected token, not only after interactive auth
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@appleboy appleboy merged commit 33a5e01 into main May 5, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants