Repository navigation
Simplify the kagent install docs for kagent-dev/kagent#3566 - #705
Merged
Merged
Conversation
Contributor
Docs preview
Both are uploaded Worker versions and serve no production traffic. |
Hold until a kagent release that includes #3566 ships and the version conref is bumped. - CLI install: drop the grpcReflection values file and take --provider instead of a config file for the provider. Keep the clusterDomain step, since kagent install does not detect the domain; the CLI config file now lives there. - Install the CLI with curl -sL https://kagent.dev/install | bash, which installs the newest release; --version pins one. List the published platforms. - Document the kagent-default, codex-default and claude-default Harnesses (namespace-local to the release namespace), the harnesses.* Helm values with the s3://ate-snapshots/kagent/ default, and add a verify step. - grpcurl guides: drop the grpcReflection step for kagent install (Helm installs still set it) and explain that reflection needs the same authentication as other gRPC calls, in a shared grpcurl-reflection snippet. - Debug: golden build image-pull failures now name the image. - UI: describe the Harness and Agent form improvements, ModelConfig dropdowns and the agent page's update-failure reason. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Eitan Yarmush <eitan.yarmush@solo.io>
The CLI install is now: export OPENAI_API_KEY=... curl -sL https://kagent.dev/install | bash && kagent install kagent install defaults to the kagent namespace and waits for the install before printing next steps, so the namespace flag, the rollout wait and the tool list are gone from the main path. Providers, pinning a release, platforms, Helm values (including clusterDomain) and what the installer sets up move to a "Customize the CLI installation" section. The Helm path sets the API key in its own Secret step. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Eitan Yarmush <eitan.yarmush@solo.io>
The docs split into latest (kagent 1.0.0) and main (kagent main) after this branch started. kagent install turns reflection on only after kagent-dev/kagent#3566, which is not in 1.0.0, so the shared grpcurl prerequisite keeps the grpcReflection step on latest and uses the new reflection text on main. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Eitan Yarmush <eitan.yarmush@solo.io>
EItanya
force-pushed
the
docs/install-onboarding-3566
branch
from
November 10, 2026 00:21
f8947ce to
58e828c
Compare
EItanya
marked this pull request as ready for review
November 10, 2026 00:22
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Eitan Yarmush <eitan.yarmush@solo.io>
EItanya
changed the title
sebbycorp
self-requested a review
November 10, 2026 00:34
sebbycorp
approved these changes
Nov 10, 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
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
Docs for the onboarding changes in kagent-dev/kagent#3566. That PR is on kagent
mainbut not in v1.0.0, so these changes go to themaindocs (content/kagent/main/). Thelatest(1.0.0) docs are unchanged except where noted.export OPENAI_API_KEY=...andcurl -sL https://kagent.dev/install | bash && kagent install. A new "Customize the CLI installation" section covers--provider,--versionpinning, the supported platforms, passing Helm values through the CLI config file (includingglobal.clusterDomain, whichkagent installdoes not detect), and what the installer sets up.kagent-default,codex-defaultandclaude-default, and thatspec.harnessRefis namespace-local. The Helm path coversharnesses.enabled,harnesses.snapshotLocation(defaults3://ate-snapshots/kagent/) andharnesses.<runtime>.enabled. A verify step lists the Harnesses.kagent installusers no longer setconfig.server.grpcReflection(Helm installs still do). A newgrpcurl-reflectionsnippet explains that reflection needs the configured authentication: anonymous ininsecuremode, credentials otherwise. The examples in the identity page are updated to match.could not pull image <ref>.Shared snippets (affect
latesttoo)install-cli.mdnow usescurl -sL https://kagent.dev/install | bash, with--versionas an option. This works for 1.0.0: I ran the live script with and without--version v1.0.0, and both installed the 1.0.0 CLI.grpcurl-prerequisites.mdis gated withversion include-if:latestkeeps the 1.0.0grpcReflectionstep andmaingets the new reflection text. I checked both on the preview.Blog
curl -sL https://kagent.dev/install | bash -s -- --version v1.0.0instead of the raw GitHub URL.Testing
latest/examples/a2a-agentsandmain/examples/a2a-agentsshow the correct grpcurl prerequisite. Themaininstall page shows the two-line install, and thelatestinstall page is unchanged.get-kagentfromhttps://kagent.dev/installagainst v1.0.0, pinned and unpinned.🤖 Generated with Claude Code