docs: reconcile docs site with REST-only SCM + standardized LLM config - #152
Merged
Conversation
Update the Nextra docs to match the shipped operator surface (PR #134): - SCM is REST-only: drop glab/gh from prerequisites and recipes; the token is now the credential for the tokenized HTTPS clone (per-call auth header, never written to .git/config). Remove denied_tools_regex. - Posting goes through the REST API for both providers; drop the MCP-first posting description and BUBO_GITHUB_MCP_TOOL / create_merge_request_thread. - LLM config: document llm_model (now drives the model via bubo init), llm_model_effort (low/medium/high), llm_base_url (OpenAI-compatible endpoint), and the login-based auth model. Mark llm_api_key_env deprecated and stop emitting it in generated configs; the self-hosted recipe now uses llm_base_url, which bubo init templates into the Codex profile. - Add the [analytics] section (opt-out; BUBO_ANALYTICS / DO_NOT_TRACK).
This was referenced Jul 7, 2026
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
1 participant
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.
Reconciles the Nextra docs with the operator surface shipped in #134, so no feature is undocumented and nothing stale remains. Docs-only — no code changes.
What changed
REST-only SCM
glab/ghfrom prerequisites and every recipe (mac/linux/gitlab/github); onlygitis needed now..git/config.denied_tools_regex(the GitLab-MCP tool gate) from the reference and sample config.BUBO_GITHUB_MCP_TOOL, andcreate_merge_request_thread.Standardized LLM config
llm_modelnow actually drives the model (bubo inittemplates it into the agent profile) — reflected in the reference.llm_model_effort(low/medium/high) andllm_base_url(OpenAI-compatible endpoint); document the login-based auth model (key not injected into the agent env except inllm_base_urlmode).llm_api_key_envdeprecated and stop emitting it in generated configs (build page + recipes).llm_base_url, whichbubo inittemplates into the Codex profile — replacing the old manual model-provider block.Analytics
[analytics]section (opt-out;BUBO_ANALYTICS/DO_NOT_TRACKkill-switches).Verification
next build(withNEXT_PUBLIC_BASE_PATH=/bubo) is green — all 16 pages export.llm_api_key_envappears only in its "Deprecated" reference row; new surface (llm_model_effort,llm_base_url,[analytics]) present.env.example.toml,env_config.py,review_config.py,cli.py,action.yml).