[docs] Add permission handling section to getting-started guide#20
Closed
github-actions[bot] wants to merge 1 commit intomainfrom
Closed
[docs] Add permission handling section to getting-started guide#20github-actions[bot] wants to merge 1 commit intomainfrom
github-actions[bot] wants to merge 1 commit intomainfrom
Conversation
- Add Step 5 covering deny-by-default permission model - Show approve-all usage for development/trusted environments - Demonstrate custom permission handler implementation - Link to permission_bash.clj example and API reference - Renumber subsequent steps (Step 5->6, Step 6->7) Updates CHANGELOG.md with documentation changes. Addresses documentation gap identified in PR #18 review - the getting-started guide now properly introduces users to permission handling, which is critical for sessions using bash, file operations, or other restricted tools. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
github-actions
Bot
added
automation
documentation
Contributor
Author
|
This pull request was automatically closed because it expired on 2026-02-20T13:28:31.711Z.
|
auto-merge was automatically disabled
February 20, 2026 13:44
Pull request was closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation Updates - February 19, 2026
This PR enhances the getting-started guide to cover the deny-by-default permission model introduced in PR #18 (upstream PR #509 sync).
Features Documented
approve-allconvenience handler usageChanges Made
doc/getting-started.mdapprove-allusage for development/trusted environmentspermission_bash.cljexample and API referenceCHANGELOG.mdwith documentation changesWhy This Matters
PR #18 introduced the deny-by-default permission model as a breaking change. While the API reference, examples README, and main README were updated, the getting-started guide lacked coverage of this critical security feature. New users following the tutorial would encounter permission denials when using tools like bash or file operations without understanding why or how to handle them.
Validation
clojure -)../examples/permission_bash.cljexists./reference/API.md#permission-handlinganchor existsbb validate-docsfrom running)Merged PRs Referenced
Related Upstream Changes
Note: This PR was automatically generated by the daily documentation updater workflow. Human review is recommended before merging.