Repository navigation
Conversation
Adds a walkthrough of moving a Claude Code setup from an OpenShell sandbox to kagent 1.x and Agent Substrate using the built-in Claude runtime: model config, default-deny egress with credential injection, Harness/AgentTemplate/Agent, suspend and resume, and a GitHub approval gate. Includes 8 figures, the blog index entry, and an author entry. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Hugo Guerrero <1001939+hguerrero@users.noreply.github.com>
Replace the placeholder title and bio and add an author photo. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Hugo Guerrero <1001939+hguerrero@users.noreply.github.com>
sebbycorp
self-requested a review
October 7, 2026 21:06
The adapter comparison is not relevant to this post. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Hugo Guerrero <1001939+hguerrero@users.noreply.github.com>
The MDX img override read alt from the image title, so images written as  rendered with no alt attribute and next/image logged "Image is missing required alt property". Fall back to the markdown alt first, then the title. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Hugo Guerrero <1001939+hguerrero@users.noreply.github.com>
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.
Summary
Adds a new blog post, Running Claude Code on Agent Substrate: What Changes from OpenShell, by Hugo Guerrero. It is a hands-on walkthrough of running Claude Code on kagent 1.x and Agent Substrate using kagent's built-in Claude runtime (the
claude-harnessimage, so no adapter and no image to build):SecretandModelConfigHarness,AgentTemplate, andAgentRemoteMCPServerwith a per-call approval gateChanges:
src/blogContent/migrate-openshell-claude-code-to-agent-substrate-kagent.mdx: the post, with metadata per CONTRIBUTION.mdsrc/app/blog/page.tsx: index entry (slug matches the.mdxfile)src/app/blog/authors.tsandpublic/images/authors/hugoguerrero.jpg: newhugoguerreroauthor, with title, bio, and photopublic/images/blog/migrate-openshell-claude-code-to-agent-substrate-kagent/: 8 figures (PNG, 2x)Notes for reviewers
Focus guideline. The post compares against NVIDIA OpenShell and runs Claude Code, but the subject is kagent 1.x and Agent Substrate: the built-in Claude runtime, Harness/AgentTemplate/Agent, egress policy, and suspend/resume. The existing NemoClaw/OpenShell post is the precedent. Happy to adjust if maintainers prefer a different framing.
Alpha versions. The post pins what I tested on 2026-10-07: Substrate
0.3.0-alpha3, kagent and CLI1.0.0-alpha7, Claude Code2.1.260. It says so and links to the 1.x docs for current versions.Test plan
npm ciandnpm run dev:/blogand the new post both return 200, and the images loadeslinton the changed TS files is clean🤖 Generated with Claude Code