### JavaScript/TypeScript Example: Server with Environment Variables

Source: https://kiro.dev/docs/mcp/servers

Example for creating an install link for a server that requires specific environment variables, such as a database connection string.

```javascript
// Example 3: Server with environment variables
const dbServerLink = createKiroInstallLink('postgresql', {
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-postgres'],
  env: { POSTGRES_CONNECTION_STRING: 'postgresql://localhost:5432/mydb' },
  disabled: false,
  autoApprove: []
});
```

--------------------------------

### Python Example Usage

Source: https://kiro.dev/docs/mcp/servers

Example demonstrating the usage of the `create_kiro_install_link` Python function to generate an install link for a server with specified command, arguments, and approval settings.

```python
# Example usage
link = create_kiro_install_link('my-server', {
    'command': 'npx',
    'args': ['-y', '@myorg/my-mcp-server'],
    'disabled': False,
    'autoApprove': []
})
```

--------------------------------

### JavaScript/TypeScript Example: Local Server with Command Execution

Source: https://kiro.dev/docs/mcp/servers

Example demonstrating how to create an install link for a local MCP server that executes a command. It includes environment variable configuration.

```javascript
// Example 1: Local server with command execution
const localServerLink = createKiroInstallLink('aws-docs', {
  command: 'uvx',
  args: ['awslabs.aws-documentation-mcp-server@latest'],
  env: { FASTMCP_LOG_LEVEL: 'ERROR' },
  disabled: false,
  autoApprove: []
});
```

--------------------------------

### Bash Example Usage

Source: https://kiro.dev/docs/mcp/servers

Example demonstrating how to use the `create_kiro_link` Bash function with a predefined configuration string to generate an install link for a Git MCP server.

```bash
# Example usage
CONFIG='{"command":"npx","args":["-y","@modelcontextprotocol/server-git"],"disabled":false,"autoApprove":[]}'
create_kiro_link "git" "$CONFIG"
```

--------------------------------

### Example Trusted Commands Configuration (Full Wildcard)

Source: https://kiro.dev/docs/chat/terminal

Shows how to use wildcards (*) for full prefix matching in trusted commands. Any command starting with the specified prefix is auto-approved.

```text
["npm *", "git *"]
```

--------------------------------

### Example Trusted Commands Configuration (Partial Wildcard)

Source: https://kiro.dev/docs/chat/terminal

Illustrates using a wildcard (*) for partial matching in trusted commands. Commands starting with the specified prefix are auto-approved.

```text
["npm install *"]
```

--------------------------------

### Install Kotlin Language Server

Source: https://kiro.dev/docs/cli/code-intelligence

Install the Kotlin language server using Homebrew.

```bash
brew install kotlin-language-server
```

--------------------------------

### Kiro CLI Workspace Initialization Output

Source: https://kiro.dev/docs/cli/code-intelligence

Example output from `/code init` showing workspace initialization status, detected languages, project markers, and the status of available Language Servers (Initialized, Initializing, Available, Not Installed).

```text
✓ Workspace initialization started

Workspace: /path/to/your/project
Detected Languages: ["python", "rust", "typescript"]
Project Markers: ["Cargo.toml", "package.json"]

Available LSPs:
○ clangd (cpp) - available
○ gopls (go) - not installed
◐ jdtls (java) - initializing...
✓ pyright (python) - initialized (687ms)
✓ rust-analyzer (rust) - initialized (488ms)
○ solargraph (ruby) - not installed
✓ typescript-language-server (typescript) - initialized (214ms)
```

--------------------------------

### JavaScript/TypeScript Example: Remote Server with URL Endpoint

Source: https://kiro.dev/docs/mcp/servers

Example showing how to create an install link for a remote MCP server using a URL endpoint. Configuration includes disabling the server and auto-approval settings.

```javascript
// Example 2: Remote server with URL endpoint
const remoteServerLink = createKiroInstallLink('aws-knowledge', {
  url: 'https://knowledge-mcp.global.api.aws',
  disabled: false,
  autoApprove: []
});
```

--------------------------------

### Install Kiro CLI from Zip

Source: https://kiro.dev/docs/cli/installation

Run the installation script after unzipping the Kiro CLI package. This installs the CLI to ~/.local/bin by default.

```bash
./kirocli/install.sh
```

--------------------------------

### Start Kiro CLI

Source: https://kiro.dev/docs/cli

Navigate to your project directory and run the Kiro CLI to begin.

```bash
cd my-project
kiro-cli
```

--------------------------------

### Install Kiro CLI on Ubuntu

Source: https://kiro.dev/docs/cli/installation

Install the downloaded .deb package and then use apt-get to resolve any missing dependencies.

```bash
sudo dpkg -i kiro-cli.deb
sudo apt-get install -f
```

--------------------------------

### Example Global Agent File Structure

Source: https://kiro.dev/docs/cli/custom-agents/configuration-reference

An example of how global agents are organized in the ~/.kiro/agents/ directory.

```text
~/.kiro/agents/
├── general-assistant.json
├── code-reviewer.json
└── documentation-writer.json
```

--------------------------------

### Install Kiro CLI

Source: https://kiro.dev/docs/cli

Use this command to download and install the Kiro CLI script.

```bash
curl -fsSL https://cli.kiro.dev/install | bash
```

--------------------------------

### Complete Agent Configuration Example

Source: https://kiro.dev/docs/cli/custom-agents/configuration-reference

A full example of an agent configuration file, demonstrating various settings like MCP servers, tools, tool aliases, resource definitions, hooks, and model selection. Agent configuration files are JSON files that define how custom agents behave.

```json
{
  "name": "aws-rust-agent",
  "description": "A specialized agent for AWS and Rust development tasks",
  "mcpServers": {
    "fetch": {
      "command": "fetch3.1",
      "args": []
    },
    "git": {
      "command": "git-mcp",
      "args": []
    }
  },
  "tools": [
    "read",
    "write",
    "shell",
    "aws",
    "@git",
    "@fetch/fetch_url"
  ],
  "toolAliases": {
    "@git/git_status": "status",
    "@fetch/fetch_url": "get"
  },
  "allowedTools": [
    "read",
    "@git/git_status"
  ],
  "toolsSettings": {
    "write": {
      "allowedPaths": ["src/**", "tests/**", "Cargo.toml"]
    },
    "aws": {
      "allowedServices": ["s3", "lambda"]
    }
  },
  "resources": [
    "file://README.md",
    "file://docs/**/*.md"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "git status"
      }
    ],
    "userPromptSubmit": [
      {
        "command": "ls -la"
      }
    ]
  },
  "useLegacyMcpJson": true,
  "model": "claude-sonnet-4",
  "keyboardShortcut": "ctrl+r",
  "welcomeMessage": "Ready to help with AWS and Rust development!"
}
```

--------------------------------

### Install C/C++ Language Server (clangd)

Source: https://kiro.dev/docs/cli/code-intelligence

Install the clangd language server for C/C++ projects. Use Homebrew on macOS or apt/pacman on Linux.

```bash
# macOS
brew install llvm
# or
brew install clangd

# Linux (Debian/Ubuntu)
sudo apt install clangd

# Linux (Arch)
sudo pacman -S clang
```

--------------------------------

### Verify uv and Python Installation

Source: https://kiro.dev/docs/troubleshooting

These commands help verify the installation of 'uv' and 'python' for the AWS documentation server. Ensure you have Python 3.10+ installed.

```bash
# Verify uv installation
uv --version

# Verify Python version
python --version
```

--------------------------------

### Interacting with the Guide Agent

Source: https://kiro.dev/docs/cli/quick-start

Engage in a conversation with the guide agent to understand Kiro CLI's capabilities and project setup. Ask questions about workflows, code reviews, and account connections.

```bash
[guide] > What can you help me with?

[guide] > How should I set up this project to work well with Kiro?

[guide] > What's the best way to do code reviews with Kiro?

[guide] > How do I connect my GitHub account?
```

--------------------------------

### CI/CD Examples: Test Generation and Troubleshooting

Source: https://kiro.dev/docs/cli/headless

Examples of using Kiro CLI in CI/CD for generating and running tests, or troubleshooting build failures by piping log output.

```bash
# Generate and run tests
kiro-cli chat --no-interactive --trust-all-tools "Write tests for the auth module and run them"
```

```bash
# Troubleshoot a failing build
cat build-error.log | kiro-cli chat --no-interactive "Explain this build failure and suggest a fix"
```

--------------------------------

### Example Local Agent File Structure

Source: https://kiro.dev/docs/cli/custom-agents/configuration-reference

An example of how local agents are organized within a project's .kiro/agents/ directory.

```text
my-project/
├── .kiro/
│   └── agents/
│       ├── dev-agent.json
│       └── aws-specialist.json
└── src/
    └── main.py
```

--------------------------------

### Install Go Language Server (gopls)

Source: https://kiro.dev/docs/cli/code-intelligence

Install the gopls language server for Go projects using the go command. Ensure your Go environment is set up correctly.

```bash
go install golang.org/x/tools/gopls@latest
```

--------------------------------

### Explain Code

Source: https://kiro.dev/docs/chat

Use this example to ask Kiro for an explanation of how a specific part of your project works.

```natural language
"Explain how authentication works in this project"
```

--------------------------------

### Install Ruby Solargraph Language Server

Source: https://kiro.dev/docs/cli/code-intelligence

Install the Solargraph language server for Ruby projects using the gem command.

```bash
gem install solargraph
```

--------------------------------

### Install Rust Analyzer

Source: https://kiro.dev/docs/cli/code-intelligence

Install the rust-analyzer component using rustup. This provides language server features for Rust projects.

```bash
rustup component add rust-analyzer
```

--------------------------------

### Start a Basic Chat Session

Source: https://kiro.dev/docs/cli/chat

Initiates an interactive chat session with the Kiro CLI. This is the default way to start a conversation.

```bash
kiro-cli
```

--------------------------------

### Development Workflow Example

Source: https://kiro.dev/docs/chat/dev-servers

An example of a development workflow that includes checking the output of the `npm run dev` process for compilation errors or warnings.

```markdown
# Development Workflow

After making code changes:
1. Always check the output of the `npm run dev` process
2. Look for compilation errors or warnings
3. If errors exist, suggest fixes before proceeding
```

--------------------------------

### Install Python Pyright Language Server

Source: https://kiro.dev/docs/cli/code-intelligence

Install the Pyright language server for Python projects using pip. Using pipx is recommended for better isolation.

```bash
pip install pyright
# or with pipx (recommended for isolation)
pipx install pyright
```

--------------------------------

### Accessing the Kiro CLI Guide Agent

Source: https://kiro.dev/docs/cli/quick-start

Launch the guide agent within a Kiro CLI session by typing '/guide'. This agent can answer questions about commands, tools, settings, and best practices.

```bash
> /guide
```

--------------------------------

### Verify Dependencies

Source: https://kiro.dev/docs/guides/learn-by-playing/00-setup

Run this script to ensure all prerequisite dependencies for local development are correctly installed and configured.

```bash
./scripts/check-dependencies.sh
```

--------------------------------

### Example Usage for Frontend MCP Server

Source: https://kiro.dev/docs/guides/languages-and-frameworks/typescript-javascript-guide

Examples of natural language prompts to interact with the Frontend MCP server for React development knowledge and troubleshooting.

```natural-language
"Get essential knowledge for React development"
```

```natural-language
"Help me troubleshoot this React component issue"
```

```natural-language
"Show me best practices for modern React applications"
```

--------------------------------

### Get Codebase Overview

Source: https://kiro.dev/docs/cli/code-intelligence

Generates a comprehensive overview of the entire workspace. Use this for onboarding or understanding project structure.

```bash
/code overview
```

--------------------------------

### Example allowedTools Configuration

Source: https://kiro.dev/docs/cli/custom-agents/configuration-reference

Demonstrates the structure of the `allowedTools` field, including exact matches and various wildcard patterns for both built-in and MCP tools.

```json
{
  "allowedTools": [
    "read",
    "write",
    "@git/git_status",
    "@server/read_*",
    "@fetch"
  ]
}
```

--------------------------------

### SKILL.md Frontmatter and Content Example

Source: https://kiro.dev/docs/skills

The SKILL.md file includes frontmatter for metadata and a markdown section for describing the review process.

```markdown
---
name: pr-review
description: Review pull requests for code quality, security issues, and test coverage. Use when reviewing PRs or preparing code for review.
---

## Review process

1. Check for security vulnerabilities
2. Verify error handling
3. Confirm test coverage
4. Review naming and structure
```

--------------------------------

### Example Universal Trust Configuration

Source: https://kiro.dev/docs/chat/terminal

Configuration to trust all commands. Use with extreme caution as it bypasses all security checks.

```text
["*"]
```

--------------------------------

### Start New Conversation with Initial Prompt

Source: https://kiro.dev/docs/cli/chat

Initiates a new conversation with a specific starting prompt, guiding the AI's initial response.

```bash
/chat new how do I set up a React project
```

--------------------------------

### SQL Example: Creating a Profiles Table

Source: https://kiro.dev/docs/powers/create

Demonstrates how to create a 'profiles' table in SQL, including columns for ID, username, and creation timestamp, with specific constraints and default values.

```sql
create table profiles (
  id uuid primary key default gen_random_uuid(),
  username text unique not null,
  created_at timestamptz default now()
);
```

--------------------------------

### Project Setup Prompts for Java

Source: https://kiro.dev/docs/guides/languages-and-frameworks/java-guide

Use these prompts to initialize configuration files, create project structures, and set up your Java development environment with Kiro.

```text
"Create a new Maven project for a Spring Boot application"
```

```text
"Set up a Gradle build file with JUnit 5 and Mockito dependencies"
```

```text
"Configure a multi-module Maven project structure"
```

```text
"Help me install and configure the latest JDK for my operating system"
```

```text
"Set up a Spring Boot project with proper layered architecture"
```

```text
"Create a pom.xml with Spring Security and JPA dependencies"
```

--------------------------------

### Build and Launch Game Stack with Podman

Source: https://kiro.dev/docs/guides/learn-by-playing/00-setup

Build and launch the game stack using Podman Compose. Use the --watch flag for live updates and --remove-orphans to clean up unused containers. The --timeout and --force-recreate flags ensure a clean startup.

```bash
podman compose build &&
podman compose up \
  --watch \
  --remove-orphans \
  --timeout 0 \
  --force-recreate
```

--------------------------------

### Initialize Python Project Configuration Files

Source: https://kiro.dev/docs/guides/languages-and-frameworks/python-guide

Use Kiro to set up essential configuration files like requirements.txt, .env, and pyproject.toml for various Python frameworks and tools.

```text
"Set up a requirements.txt with development dependencies"
"Configure a .env file for my Django application"
"Create a pyproject.toml for a FastAPI project with pytest and black"
```

--------------------------------

### Unzip Kiro CLI Installer

Source: https://kiro.dev/docs/cli/installation

Extract the Kiro CLI installation files from the downloaded zip archive.

```bash
unzip kirocli.zip
```

--------------------------------

### Initialize and Commit Power to GitHub

Source: https://kiro.dev/docs/powers/create

Steps to initialize a Git repository, add power files, commit changes, and push to a remote repository for sharing. Ensure the repository is public for broad accessibility.

```bash
git init
git add POWER.md mcp.json steering/
git commit -m "Initial release"
git push origin main
```

--------------------------------

### Steering File Mapping Example

Source: https://kiro.dev/docs/powers/create

Illustrates how to map different development workflows to specific steering files within a Kiro power. This approach helps manage complex tools by loading relevant guidance contextually.

```markdown
# When to Load Steering Files
- Setting up a database → `database-setup-workflow.md`
- Writing or formatting SQL code → `supabase-code-format-sql.md`
- Creating or modifying RLS policies → `supabase-database-rls-policies.md`
- Creating PostgreSQL functions → `supabase-database-functions.md`
- Working with declarative schema (`supabase/schemas/` directory) → `supabase-declarative-database-schema.md`
- Setting up or modifying Next.js authentication with Supabase SSR → `supabase-nextjs-supabase-auth.md`
- Implementing realtime features (broadcast, presence, channels, subscriptions) → `supabase-use-realtime.md`
```

--------------------------------

### Example Trusted Commands Configuration (Exact Match)

Source: https://kiro.dev/docs/chat/terminal

Demonstrates exact matching for trusted commands. Commands must precisely match the entries in the trusted list to be auto-approved.

```text
["npm install", "git status"]
```

--------------------------------

### Verify Kiro CLI Installation

Source: https://kiro.dev/docs/cli/autocomplete

Check if Kiro CLI is installed and retrieve its version number. This is a basic troubleshooting step.

```bash
kiro-cli --version
```

--------------------------------

### Create Session and Send Prompt

Source: https://kiro.dev/docs/cli/acp

After initialization, create a new session with a specified working directory and then send a prompt to the agent within that session.

```json
// Create a new session
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "session/new",
  "params": {
    "cwd": "/home/user/my-project",
    "mcpServers": []
  }
}

// Send a prompt
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "session/prompt",
  "params": {
    "sessionId": "sess_abc123",
    "content": [
      {
        "type": "text",
        "text": "Explain this codebase"
      }
    ]
  }
}
```

--------------------------------

### Example MCP Server Configuration

Source: https://kiro.dev/docs/mcp/configuration

This snippet shows a basic configuration for an MCP server named 'web-search', specifying the command to run and its arguments, along with environment variables.

```json
{
  "mcpServers": {
    "web-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-bravesearch"
      ],
      "env": {
        "BRAVE_API_KEY": "${BRAVE_API_KEY}"
      }
    }
  }
}
```

--------------------------------

### Example Commit Message Output

Source: https://kiro.dev/docs/guides/learn-by-playing/07-extending-kiro-with-mcp

An example of a commit message generated from the knowledge graph observations, detailing the changes made.

```markdown
docs: transform README.md with pirate-themed language
- Rewrote entire README.md in pirate style
- Added nautical references and pirate slang throughout
- Maintained all original information and links
- Changed section titles to pirate-appropriate terms
- Added humorous pirate expressions and threats
- Preserved functionality while enhancing user experience with thematic language
```

--------------------------------

### Example Conventional Commit Message

Source: https://kiro.dev/docs/editor/source-control

An example of a commit message following the Conventional Commits format, detailing documentation changes.

```markdown
feat(docs): add comprehensive Source Control documentation
- Create new documentation page for Source Control features
- Update interface documentation to link to Source Control page
- Provide detailed explanation of AI-powered commit message generation
- Describe diff context provider and commit message generation process
```

--------------------------------

### File Reference Examples

Source: https://kiro.dev/docs/steering

Demonstrates how to use the file reference syntax for different types of files like API specifications, component definitions, and configuration templates.

```markdown
#[[file:api/openapi.yaml]]
```

```markdown
#[[file:components/ui/button.tsx]]
```

```markdown
#[[file:.env.example]]
```

--------------------------------

### Start Chat Session with Specific Agent

Source: https://kiro.dev/docs/cli/chat

Starts a chat session with a pre-defined agent. Use this to engage with a specialized AI persona.

```bash
kiro-cli --agent myagent
```

--------------------------------

### Install TypeScript Language Server

Source: https://kiro.dev/docs/cli/code-intelligence

Install the TypeScript language server and TypeScript globally using npm. This is required for TypeScript/JavaScript code intelligence.

```bash
npm install -g typescript-language-server typescript
```

--------------------------------

### Configure Project Context with Steering File

Source: https://kiro.dev/docs/cli/quick-start

Create a .kiro/steering/project.md file to define your project's stack, package manager, coding style, testing framework, and component preferences. This helps Kiro provide more accurate and tailored responses.

```markdown
# Project Context

- This is a TypeScript project using Next.js 15
- Use pnpm for package management
- Follow the existing code style (Prettier + ESLint)
- Write tests with Vitest
- Prefer functional components with hooks

```

--------------------------------

### Initialize Kiro CLI Workspace for LSP

Source: https://kiro.dev/docs/cli/code-intelligence

Run the `/code init` command in your project root to create LSP configuration and start language servers. This command detects languages and initializes available LSPs.

```bash
/code init
```

--------------------------------

### Install Kiro CLI on Windows 11

Source: https://kiro.dev/docs/cli/installation

Use this PowerShell command to install the Kiro CLI on Windows 11. Requires Windows Terminal or PowerShell.

```powershell
irm 'https://cli.kiro.dev/install.ps1' | iex
```

--------------------------------

### Create a Custom Agent for Code Review

Source: https://kiro.dev/docs/cli/quick-start

Use the Guide agent to generate a new custom agent configuration file for code review. You can later switch to this agent using a specific command.

```bash
/guide Create an agent for code review
```

--------------------------------

### View and Manage Experimental Settings

Source: https://kiro.dev/docs/cli/experimental

Use these commands to list all experimental settings and to enable or disable specific features. Ensure you are in the correct directory or context for the CLI to operate.

```bash
# View all experimental settings
kiro-cli settings list | grep -i enable

# Enable/disable specific experiments
kiro-cli settings chat.enableKnowledge true
kiro-cli settings chat.enableTangentMode true
kiro-cli settings chat.enableTodoList true
kiro-cli settings chat.enableThinking true
kiro-cli settings chat.enableCheckpoint true
kiro-cli settings chat.enableContextUsageIndicator true
kiro-cli settings chat.enableDelegate true
```

--------------------------------

### JavaScript/TypeScript Function to Create Kiro Install Link

Source: https://kiro.dev/docs/mcp/servers

Use this function to programmatically generate Kiro installation links. It handles URL encoding for server names and configurations.

```javascript
function createKiroInstallLink(name, config) {
  const encodedName = encodeURIComponent(name);
  const encodedConfig = encodeURIComponent(JSON.stringify(config));
  return `https://kiro.dev/launch/mcp/add?name=${encodedName}&config=${encodedConfig}`;
}
```

--------------------------------

### Handling Dependency Problems with #terminal

Source: https://kiro.dev/docs/chat

Utilize the #terminal provider to troubleshoot dependency installation errors by sharing the output and error messages from commands like 'npm install'.

```markdown
#terminal npm install is throwing errors
```

--------------------------------

### Bash Function to Create Kiro Install Link

Source: https://kiro.dev/docs/mcp/servers

A Bash script function to generate Kiro installation links. It utilizes `jq` for URL encoding of the server name and configuration.

```bash
# Function to create Kiro install link
create_kiro_link() {
  local name="$1"
  local config="$2"
  
  # URL encode the parameters
  local encoded_name=$(printf %s "$name" | jq -sRr @uri)
  local encoded_config=$(printf %s "$config" | jq -sRr @uri)
  
  echo "https://kiro.dev/launch/mcp/add?name=${encoded_name}&config=${encoded_config}"
}
```

--------------------------------

### Using #repository Context Provider

Source: https://kiro.dev/docs/chat

Include a map of your repository structure with the #repository provider to understand the project's organization.

```markdown
#repository how is this project organized?
```

--------------------------------

### Python Function to Create Kiro Install Link

Source: https://kiro.dev/docs/mcp/servers

A Python function to generate Kiro installation links, ensuring proper URL encoding of the server name and configuration dictionary.

```python
import json
from urllib.parse import urlencode, quote

def create_kiro_install_link(name: str, config: dict) -> str:
    """
    Creates a Kiro install link for one-click MCP server installation
    
    Args:
        name: Display name for the MCP server
        config: MCP server configuration dictionary
        
    Returns:
        Formatted HTTPS install link URL
    """
    encoded_name = quote(name)
    encoded_config = quote(json.dumps(config))
    return f"https://kiro.dev/launch/mcp/add?name={encoded_name}&config={encoded_config}"
```

--------------------------------

### Install Java Language Server (jdtls)

Source: https://kiro.dev/docs/cli/code-intelligence

Install the JDT Language Server (jdtls) for Java projects. Use Homebrew on macOS or download from the official Eclipse JDTLS snapshots for Linux.

```bash
# macOS
brew install jdtls

# Linux - download from https://download.eclipse.org/jdtls/snapshots/
# Extract and add to PATH
```

--------------------------------

### MCP PreToolUse Hook Event Example

Source: https://kiro.dev/docs/cli/hooks

This example shows a PreToolUse hook event for MCP tools, where the tool name includes the full namespaced format including the MCP Server name.

```json
{
  "hook_event_name": "preToolUse",
  "cwd": "/current/working/directory",
  "session_id": "abc123-def456-789",
  "tool_name": "@postgres/query",
  "tool_input": {
    "sql": "SELECT * FROM orders LIMIT 10;"
  }
}
```

--------------------------------

### Complete Agent Configuration Example

Source: https://kiro.dev/docs/cli/custom-agents/configuration-reference

This JSON object defines a complete configuration for a custom agent, specifying its name, description, prompt file, MCP servers, tools, tool aliases, allowed tools, tool settings, resources, hooks, model, and keyboard shortcut.

```json
{
  "name": "aws-rust-agent",
  "description": "Specialized agent for AWS and Rust development",
  "prompt": "file://./prompts/aws-rust-expert.md",
  "mcpServers": {
    "fetch": {
      "command": "fetch-server",
      "args": []
    },
    "git": {
      "command": "git-mcp",
      "args": []
    }
  },
  "tools": [
    "read",
    "write",
    "shell",
    "aws",
    "@git",
    "@fetch/fetch_url"
  ],
  "toolAliases": {
    "@git/git_status": "status",
    "@fetch/fetch_url": "get"
  },
  "allowedTools": [
    "read",
    "@git/git_status"
  ],
  "toolsSettings": {
    "write": {
      "allowedPaths": ["src/**", "tests/**", "Cargo.toml"]
    },
    "aws": {
      "allowedServices": ["s3", "lambda"],
      "autoAllowReadonly": true
    }
  },
  "resources": [
    "file://README.md",
    "file://docs/**/*.md"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "git status"
      }
    ],
    "postToolUse": [
      {
        "matcher": "fs_write",
        "command": "cargo fmt --all"
      }
    ]
  },
  "model": "claude-sonnet-4",
  "keyboardShortcut": "ctrl+shift+r",
  "welcomeMessage": "Ready to help with AWS and Rust development!"
}
```

--------------------------------

### Kiro Hook Configuration Example

Source: https://kiro.dev/docs/powers/create

An example JSON configuration for a Kiro hook named 'Review Database Performance & Security'. This hook is triggered by user actions and prompts the agent to execute a specific MCP command.

```json
{
  "enabled": true,
  "name": "Review Database Performance & Security",
  "description": "Verify database follows performance/security best practices",
  "version": "1",
  "when": {
    "type": "userTriggered"
  },
  "then": {
    "type": "askAgent",
    "prompt": "Execute `get_advisors` via MCP to check for performance and security concerns"
  }
}
```

--------------------------------

### Using #url Context Provider

Source: https://kiro.dev/docs/chat

Include web documentation by providing a URL with the #url provider to ask questions about external APIs or documentation.

```markdown
#url:https://docs.example.com/api explain this API
```