Repository navigation
feat: provider extensibility and proactive starting-account selection - #2
Merged
Merged
Conversation
…tion Provider extensibility: user config now appends to catalog retry and passthrough lists by default, with *_replace siblings to override them outright. Adds a validation module behind `config validate` and `doctor`, an `examplecli` reference provider, and an authoring guide. Proactive starting-account selection: when quota data is available, clifwrap picks the account with the most headroom before the first upstream call instead of always starting on a possibly depleted default. Enabled by default for providers with `status_command` or `usage`; opt out per provider with `proactive_pick = false`. Also hardens the new surfaces following a pre-release audit: - doctor probes are opt-in via `--probe` so casual and CI runs no longer resolve credentials or make authenticated calls as a side effect - probe findings report exit status only, never subprocess output or interpolated argv, keeping tokens out of `doctor --json` - *_replace keys now apply to providers with no catalog entry, where they previously resolved to an empty list
added 2 commits
July 25, 2026 04:33
Add catalog providers for `agent` and legacy `cursor-agent` matching Cursor's install layout and CLI syntax (interactive TUI, `agent -p` print mode, CURSOR_API_KEY auth, login/status passthrough). Introduce interactive_mode=tty-exec so full-screen TUIs keep a live terminal instead of being buffered; headless `-p`/`--print` runs still get retry failover across API-key accounts.
Rename the alternate provider to agentcli, scrub vendor tokens from docs/tests/catalog comments, and block the token in the anonymity guard so templates stay vendor-neutral.
bodencrouch
added a commit
that referenced
this pull request
Aug 14, 2026
…-components--clifwrap chore(main): release 0.2.0
bodencrouch
added a commit
that referenced
this pull request
Aug 14, 2026
…#2) * feat: add provider extensibility and proactive starting-account selection Provider extensibility: user config now appends to catalog retry and passthrough lists by default, with *_replace siblings to override them outright. Adds a validation module behind `config validate` and `doctor`, an `examplecli` reference provider, and an authoring guide. Proactive starting-account selection: when quota data is available, clifwrap picks the account with the most headroom before the first upstream call instead of always starting on a possibly depleted default. Enabled by default for providers with `status_command` or `usage`; opt out per provider with `proactive_pick = false`. Also hardens the new surfaces following a pre-release audit: - doctor probes are opt-in via `--probe` so casual and CI runs no longer resolve credentials or make authenticated calls as a side effect - probe findings report exit status only, never subprocess output or interpolated argv, keeping tokens out of `doctor --json` - *_replace keys now apply to providers with no catalog entry, where they previously resolved to an empty list * feat: wrap Cursor Agent CLI with tty-exec and print-mode failover Add catalog providers for `agent` and legacy `cursor-agent` matching Cursor's install layout and CLI syntax (interactive TUI, `agent -p` print mode, CURSOR_API_KEY auth, login/status passthrough). Introduce interactive_mode=tty-exec so full-screen TUIs keep a live terminal instead of being buffered; headless `-p`/`--print` runs still get retry failover across API-key accounts. * chore: anonymize agent CLI catalog and docs Rename the alternate provider to agentcli, scrub vendor tokens from docs/tests/catalog comments, and block the token in the anonymity guard so templates stay vendor-neutral. --------- Co-authored-by: Copilot <th3w1zard1@users.noreply.github.com>
bodencrouch
added a commit
that referenced
this pull request
Aug 14, 2026
…#2) * feat: add provider extensibility and proactive starting-account selection Provider extensibility: user config now appends to catalog retry and passthrough lists by default, with *_replace siblings to override them outright. Adds a validation module behind `config validate` and `doctor`, an `examplecli` reference provider, and an authoring guide. Proactive starting-account selection: when quota data is available, clifwrap picks the account with the most headroom before the first upstream call instead of always starting on a possibly depleted default. Enabled by default for providers with `status_command` or `usage`; opt out per provider with `proactive_pick = false`. Also hardens the new surfaces following a pre-release audit: - doctor probes are opt-in via `--probe` so casual and CI runs no longer resolve credentials or make authenticated calls as a side effect - probe findings report exit status only, never subprocess output or interpolated argv, keeping tokens out of `doctor --json` - *_replace keys now apply to providers with no catalog entry, where they previously resolved to an empty list * feat: wrap Cursor Agent CLI with tty-exec and print-mode failover Add catalog providers for `agent` and legacy `cursor-agent` matching Cursor's install layout and CLI syntax (interactive TUI, `agent -p` print mode, CURSOR_API_KEY auth, login/status passthrough). Introduce interactive_mode=tty-exec so full-screen TUIs keep a live terminal instead of being buffered; headless `-p`/`--print` runs still get retry failover across API-key accounts. * chore: anonymize agent CLI catalog and docs Rename the alternate provider to agentcli, scrub vendor tokens from docs/tests/catalog comments, and block the token in the anonymity guard so templates stay vendor-neutral. --------- Co-authored-by: Copilot <th3w1zard1@users.noreply.github.com>
bodencrouch
pushed a commit
that referenced
this pull request
Sep 28, 2026
…-components--clifwrap chore(main): release 0.2.0
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.
Summary
*_replacesiblings to override outright. Addssrc/clifwrap/validation.pybehindconfig validateanddoctor, anexampleclireference provider, anddocs/provider-authoring.md.status_commandorusage; opt out withproactive_pick = false. Reactive failover is unchanged.Audit fixes included
doctorresolved credentials and made authenticated calls on every run--probe(--all-accountsimplies it)status_commandlanded indoctor --json*_replacekeys silently resolved to an empty list for providers with no catalog entryTest plan
pytest— 120 passedruff check src/clifwrap tests scripts— cleanpython scripts/verify_release.py --skip-tests --skip-pyinstaller— passedpython scripts/check_anonymity.py— passeddoctor --probe --json, probes off without--probe,proactive_pick = falseat runtime,*_replaceon a non-catalog provider