README
¶
Kodelet
Kodelet is a lightweight agentic SWE Agent. It runs as an interactive CLI tool in your terminal. It is capable of peforming software engineering and production operating tasks.
Key Features
- Intelligent Engineering Assistant: Automates software engineering tasks and production operations with agentic capabilities.
- Interactive Architecture Design: Collaboratively design and refine system architectures through natural dialogue.
- Continuous Code Intelligence: Analyzes, understands, and improves your codebase while answering technical questions in context.
- Reusable Fragments/Receipts: Create template-based prompts with variable substitution and bash command execution for routine tasks.
- Vision Capabilities: Support for image inputs including screenshots, diagrams, and mockups (Anthropic Claude models).
Installation
Via Homebrew (macOS/Linux)
brew tap jingkaihe/kodelet
brew install kodelet
Via Install Script
curl -sSL https://raw.githubusercontent.com/jingkaihe/kodelet/main/install.sh | bash
Choice of LLM
Kodelet supports Anthropic Claude, OpenAI compatible models and Google Gemini. Currently we recommend using Claude Sonnet 4.5 for standard tasks and Claude 3.5 Haiku for lightweight tasks.
Development
For detailed development instructions, including prerequisites, running locally, configuration options, and available mise tasks, please see the Development Guide.
License
This project is licensed under the MIT License - see the LICENSE file for details. Copyright (c) 2025 Jingkai He.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
kodelet
command
Package main provides the entry point for the Kodelet CLI application.
|
Package main provides the entry point for the Kodelet CLI application. |
|
pkg
|
|
|
auth
Package auth provides authentication mechanisms for various AI providers.
|
Package auth provides authentication mechanisms for various AI providers. |
|
conversations
Package conversations provides conversation management functionality for kodelet.
|
Package conversations provides conversation management functionality for kodelet. |
|
conversations/sqlite
Package sqlite provides SQLite-specific implementation for conversation storage.
|
Package sqlite provides SQLite-specific implementation for conversation storage. |
|
feedback
Package feedback provides functionality for managing user feedback messages for autonomous conversations in kodelet.
|
Package feedback provides functionality for managing user feedback messages for autonomous conversations in kodelet. |
|
fragments
Package fragments provides a template system for reusable prompt fragments and recipes.
|
Package fragments provides a template system for reusable prompt fragments and recipes. |
|
github
Package github provides GitHub Actions workflow templates and utilities for generating and rendering GitHub workflow files.
|
Package github provides GitHub Actions workflow templates and utilities for generating and rendering GitHub workflow files. |
|
hooks
Package hooks provides an extensibility mechanism for agent lifecycle events.
|
Package hooks provides an extensibility mechanism for agent lifecycle events. |
|
ide
Package ide manages IDE context integration for kodelet.
|
Package ide manages IDE context integration for kodelet. |
|
llm
Package llm provides a unified interface for Large Language Model providers.
|
Package llm provides a unified interface for Large Language Model providers. |
|
llm/anthropic
Package anthropic provides a client implementation for interacting with Anthropic's Claude AI models.
|
Package anthropic provides a client implementation for interacting with Anthropic's Claude AI models. |
|
llm/google
Package google provides a client implementation for interacting with Google's GenAI models.
|
Package google provides a client implementation for interacting with Google's GenAI models. |
|
llm/openai
Package openai provides a client implementation for interacting with OpenAI and OpenAI-compatible AI models.
|
Package openai provides a client implementation for interacting with OpenAI and OpenAI-compatible AI models. |
|
llm/openai/preset/openai
Package openai provides preset configurations for OpenAI models
|
Package openai provides preset configurations for OpenAI models |
|
llm/openai/preset/xai
Package xai provides preset configurations for xAI Grok models
|
Package xai provides preset configurations for xAI Grok models |
|
llm/prompts
Package prompts provides common prompt templates for LLM interactions including context compacting prompts and other reusable prompt text used throughout kodelet's LLM communication.
|
Package prompts provides common prompt templates for LLM interactions including context compacting prompts and other reusable prompt text used throughout kodelet's LLM communication. |
|
llmstxt
Package llmstxt provides access to the embedded llms.txt content.
|
Package llmstxt provides access to the embedded llms.txt content. |
|
logger
Package logger provides context-aware structured logging functionality using logrus.
|
Package logger provides context-aware structured logging functionality using logrus. |
|
mcp
Package mcp provides Model Context Protocol integration for kodelet.
|
Package mcp provides Model Context Protocol integration for kodelet. |
|
mcp/codegen
Package codegen provides code generation for MCP tools.
|
Package codegen provides code generation for MCP tools. |
|
mcp/rpc
Package rpc provides an RPC server for code execution to call MCP tools.
|
Package rpc provides an RPC server for code execution to call MCP tools. |
|
mcp/runtime
Package runtime provides code execution runtime implementations.
|
Package runtime provides code execution runtime implementations. |
|
osutil
Package osutil provides common utility functions for kodelet including content formatting with line numbers, process management, language detection, domain filtering, and various helper functions used across the application.
|
Package osutil provides common utility functions for kodelet including content formatting with line numbers, process management, language detection, domain filtering, and various helper functions used across the application. |
|
presenter
Package presenter provides consistent CLI output functionality for user-facing messages, including success, error, warning, and informational output with color support and quiet mode.
|
Package presenter provides consistent CLI output functionality for user-facing messages, including success, error, warning, and informational output with color support and quiet mode. |
|
skills
Package skills provides an agentic skills system where the model can autonomously invoke specialized capabilities based on task context.
|
Package skills provides an agentic skills system where the model can autonomously invoke specialized capabilities based on task context. |
|
sysprompt
Package sysprompt provides system prompt generation and template rendering for LLM interactions.
|
Package sysprompt provides system prompt generation and template rendering for LLM interactions. |
|
telemetry
Package telemetry provides OpenTelemetry tracing for Kodelet
|
Package telemetry provides OpenTelemetry tracing for Kodelet |
|
tools
Package tools provides the core tool execution framework for Kodelet.
|
Package tools provides the core tool execution framework for Kodelet. |
|
tools/renderers
Package renderers provides CLI output rendering functionality for tool results.
|
Package renderers provides CLI output rendering functionality for tool results. |
|
tui
Package tui provides terminal user interface components using the Bubble Tea framework.
|
Package tui provides terminal user interface components using the Bubble Tea framework. |
|
types/conversations
Package conversations defines types and interfaces for conversation data structures, query options, and conversation records used throughout kodelet's conversation management system.
|
Package conversations defines types and interfaces for conversation data structures, query options, and conversation records used throughout kodelet's conversation management system. |
|
types/llm
Package llm defines types and interfaces for Large Language Model interactions including message handlers, threads, configuration, and usage tracking for different LLM providers.
|
Package llm defines types and interfaces for Large Language Model interactions including message handlers, threads, configuration, and usage tracking for different LLM providers. |
|
types/tools
Package tools defines interfaces and types for kodelet's tool system including tool execution, result structures, state management, and JSON schema generation for LLM tool integration.
|
Package tools defines interfaces and types for kodelet's tool system including tool execution, result structures, state management, and JSON schema generation for LLM tool integration. |
|
usage
Package usage provides functionality for tracking and calculating usage statistics for LLM conversations including token counts, conversation metrics, and time-based analytics for monitoring system performance.
|
Package usage provides functionality for tracking and calculating usage statistics for LLM conversations including token counts, conversation metrics, and time-based analytics for monitoring system performance. |
|
version
Package version provides version information for kodelet including semantic version, git commit SHA, build time, and build information that are set during the build process.
|
Package version provides version information for kodelet including semantic version, git commit SHA, build time, and build information that are set during the build process. |
|
webui
Package webui provides a web server and HTTP API for kodelet's web interface.
|
Package webui provides a web server and HTTP API for kodelet's web interface. |
Click to show internal directories.
Click to hide internal directories.