# Kagent

Use kagent agents and standalone sandboxes.

- Repository: https://github.com/kagent-dev/kagent (4134 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kagent-dev/kagent --skill kagent -g -a claude-code -y`
Codex: `npx skills add kagent-dev/kagent --skill kagent -g -a codex -y`
Cursor: `npx skills add kagent-dev/kagent --skill kagent -g -a cursor -y`
Gemini CLI: `npx skills add kagent-dev/kagent --skill kagent -g -a gemini-cli -y`

## Description

Use kagent agents and standalone sandboxes. Use when configuring, invoking, sharing, or troubleshooting kagent agents, or using available kagent sandboxes as temporary workspaces to run scripts, test code, process files, and collect artifacts for an agent's own tasks.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# kagent user guide

kagent provides agent conversations through Sessions and A2A, and standalone
scratch environments through Sandboxes. Both use Substrate. Prefer the connected
deployment's tool schemas and current API over commands from earlier releases.

## Work with an agent

Use `kagent agent --help` to discover the installed agent workflow:

- `kagent agent list` and `kagent agent get NAME` discover agent definitions.
  `kagent agent template list` and `kagent agent template get NAME` inspect
  reusable AgentTemplates. These catalog commands currently require Kubernetes
  access and use the selected namespace.
- `kagent agent session create --agent NAME --request-id REQUEST_ID` creates a
  conversation. Generate and retain a request ID for retries, and keep the
  returned Session ID. Use
  `kagent agent session list` to list your conversations and
  `kagent agent session get ID` to inspect one.
- `kagent agent invoke --session ID --task "TASK"` invokes an existing
  conversation through A2A; `--stream` streams the response. Invocation does not
  create a Session automatically.
- `kagent agent session delete ID` deletes the conversation. It does not delete
  the agent definition. `kagent apply -f FILE` creates or updates an Agent or
  AgentTemplate from a manifest.

List commands accept `--page-size` and `--page-token`; get commands require one
name or ID. Session operations use the configured kagent API connection and
identity. Invocation also uses the configured gateway connection.

## Use a sandbox for your task

When a task benefits from an isolated tools environment, use available kagent
sandbox tools to execute scripts, check code, transform supplied data, or generate
artifacts. Choose an existing prepared SandboxTemplate with the needed programs.
A Sandbox can be used directly by the current agent; creating a kagent Agent or
Session is unnecessary for this workflow.

The rest: https://github.com/kagent-dev/kagent/blob/HEAD/.agents/skills/kagent/SKILL.md