@shareai-lab/kode 1.0.71 → 1.0.75

package/README.md

@@ -2,25 +2,86 @@
 
 [![npm version](https://badge.fury.io/js/@shareai-lab%2Fkode.svg)](https://www.npmjs.com/package/@shareai-lab/kode)
 [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+[![AGENTS.md](https://img.shields.io/badge/AGENTS.md-Compatible-brightgreen)](https://agents.md)
 
 [中文文档](README.zh-CN.md) | [Contributing](CONTRIBUTING.md) | [Documentation](docs/)
 
+## 🤝 AGENTS.md Standard Support
+
+**Kode proudly supports the [AGENTS.md standard protocol](https://agents.md) initiated by OpenAI** - a simple, open format for guiding programming agents that's used by 20k+ open source projects.
+
+### Full Compatibility with Multiple Standards
+
+- ✅ **AGENTS.md** - Native support for the OpenAI-initiated standard format
+- ✅ **CLAUDE.md** - Full backward compatibility with Claude Code configurations  
+- ✅ **Subagent System** - Advanced agent delegation and task orchestration
+- ✅ **Cross-platform** - Works with 20+ AI models and providers
+
+Use `# Your documentation request` to generate and maintain your AGENTS.md file automatically, while maintaining full compatibility with existing Claude Code workflows.
+
+## Overview
+
 Kode is a powerful AI assistant that lives in your terminal. It can understand your codebase, edit files, run commands, and handle entire workflows for you.
 
+> **⚠️ Security Notice**: Kode runs in YOLO mode by default (equivalent to Claude's `--dangerously-skip-permissions` flag), bypassing all permission checks for maximum productivity. YOLO mode is recommended only for trusted, secure environments when working on non-critical projects. If you're working with important files or using models of questionable capability, we strongly recommend using `kode --safe` to enable permission checks and manual approval for all operations.
+> 
+> **📊 Model Performance**: For optimal performance, we recommend using newer, more capable models designed for autonomous task completion. Avoid older Q&A-focused models like GPT-4o or Gemini 2.5 Pro, which are optimized for answering questions rather than sustained independent task execution. Choose models specifically trained for agentic workflows and extended reasoning capabilities.
+
 ## Features
 
+### Core Capabilities
 - 🤖 **AI-Powered Assistance** - Uses advanced AI models to understand and respond to your requests
 - 🔄 **Multi-Model Collaboration** - Flexibly switch and combine multiple AI models to leverage their unique strengths
+- 🦜 **Expert Model Consultation** - Use `@ask-model-name` to consult specific AI models for specialized analysis
+- 👤 **Intelligent Agent System** - Use `@run-agent-name` to delegate tasks to specialized subagents
 - 📝 **Code Editing** - Directly edit files with intelligent suggestions and improvements
 - 🔍 **Codebase Understanding** - Analyzes your project structure and code relationships
 - 🚀 **Command Execution** - Run shell commands and see results in real-time
 - 🛠️ **Workflow Automation** - Handle complex development tasks with simple prompts
+
+### 🎯 Advanced Intelligent Completion System
+Our state-of-the-art completion system provides unparalleled coding assistance:
+
+#### Smart Fuzzy Matching
+- **Hyphen-Aware Matching** - Type `dao` to match `run-agent-dao-qi-harmony-designer`
+- **Abbreviation Support** - `dq` matches `dao-qi`, `nde` matches `node`
+- **Numeric Suffix Handling** - `py3` intelligently matches `python3`
+- **Multi-Algorithm Fusion** - Combines 7+ matching algorithms for best results
+
+#### Intelligent Context Detection
+- **No @ Required** - Type `gp5` directly to match `@ask-gpt-5`
+- **Auto-Prefix Addition** - Tab/Enter automatically adds `@` for agents and models
+- **Mixed Completion** - Seamlessly switch between commands, files, agents, and models
+- **Smart Prioritization** - Results ranked by relevance and usage frequency
+
+#### Unix Command Optimization
+- **500+ Common Commands** - Curated database of frequently used Unix/Linux commands
+- **System Intersection** - Only shows commands that actually exist on your system
+- **Priority Scoring** - Common commands appear first (git, npm, docker, etc.)
+- **Real-time Loading** - Dynamic command discovery from system PATH
+
+### User Experience
 - 🎨 **Interactive UI** - Beautiful terminal interface with syntax highlighting
 - 🔌 **Tool System** - Extensible architecture with specialized tools for different tasks
 - 💾 **Context Management** - Smart context handling to maintain conversation continuity
+- 📋 **AGENTS.md Integration** - Use `# documentation requests` to auto-generate and maintain project documentation
 
 ## Installation
 
+### Recommended: Using Bun (Fastest)
+
+First install Bun if you haven't already:
+```bash
+curl -fsSL https://bun.sh/install | bash
+```
+
+Then install Kode:
+```bash
+bun add -g @shareai-lab/kode
+```
+
+### Alternative: Using npm
+
 ```bash
 npm install -g @shareai-lab/kode
 ```
@@ -50,6 +111,98 @@ kode -p "explain this function" main.js
 kwa -p "explain this function" main.js
 ```
 
+### Using the @ Mention System
+
+Kode supports a powerful @ mention system for intelligent completions:
+
+#### 🦜 Expert Model Consultation
+```bash
+# Consult specific AI models for expert opinions
+@ask-claude-sonnet-4 How should I optimize this React component for performance?
+@ask-gpt-5 What are the security implications of this authentication method?
+@ask-o1-preview Analyze the complexity of this algorithm
+```
+
+#### 👤 Specialized Agent Delegation  
+```bash
+# Delegate tasks to specialized subagents
+@run-agent-simplicity-auditor Review this code for over-engineering
+@run-agent-architect Design a microservices architecture for this system
+@run-agent-test-writer Create comprehensive tests for these modules
+```
+
+#### 📁 Smart File References
+```bash
+# Reference files and directories with auto-completion
+@src/components/Button.tsx
+@docs/api-reference.md
+@.env.example
+```
+
+The @ mention system provides intelligent completions as you type, showing available models, agents, and files.
+
+### AGENTS.md Documentation Mode
+
+Use the `#` prefix to generate and maintain your AGENTS.md documentation:
+
+```bash
+# Generate setup instructions
+# How do I set up the development environment?
+
+# Create testing documentation  
+# What are the testing procedures for this project?
+
+# Document deployment process
+# Explain the deployment pipeline and requirements
+```
+
+This mode automatically formats responses as structured documentation and appends them to your AGENTS.md file.
+
+### Docker Usage
+
+#### Alternative: Build from local source
+
+```bash
+# Clone the repository
+git clone https://github.com/shareAI-lab/Kode.git
+cd Kode
+
+# Build the image locally
+docker build --no-cache -t kode .
+
+# Run in your project directory
+cd your-project
+docker run -it --rm \
+  -v $(pwd):/workspace \
+  -v ~/.kode:/root/.kode \
+  -v ~/.kode.json:/root/.kode.json \
+  -w /workspace \
+  kode
+```
+
+#### Docker Configuration Details
+
+The Docker setup includes:
+
+- **Volume Mounts**:
+  - `$(pwd):/workspace` - Mounts your current project directory
+  - `~/.kode:/root/.kode` - Preserves your kode configuration directory between runs
+  - `~/.kode.json:/root/.kode.json` - Preserves your kode global configuration file between runs
+
+- **Working Directory**: Set to `/workspace` inside the container
+
+- **Interactive Mode**: Uses `-it` flags for interactive terminal access
+
+- **Cleanup**: `--rm` flag removes the container after exit
+
+**Note**: Kode uses both `~/.kode` directory for additional data (like memory files) and `~/.kode.json` file for global configuration.
+
+The first time you run the Docker command, it will build the image. Subsequent runs will use the cached image for faster startup.
+
+You can use the onboarding to set up the model, or `/model`.
+If you don't see the models you want on the list, you can manually set them in `/config`
+As long as you have an openai-like endpoint, it should work.
+
 ### Commands
 
 - `/help` - Show available commands
@@ -239,8 +392,14 @@ We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) f
 
 ISC License - see [LICENSE](LICENSE) for details.
 
+## Thanks
+
+- Some code from @dnakov's anonkode
+- Some UI learned from gemini-cli  
+- Some system design learned from claude code
+
 ## Support
 
 - 📚 [Documentation](docs/)
 - 🐛 [Report Issues](https://github.com/shareAI-lab/kode/issues)
-- 💬 [Discussions](https://github.com/shareAI-lab/kode/discussions)
+- 💬 [Discussions](https://github.com/shareAI-lab/kode/discussions)

package/README.zh-CN.md

@@ -7,6 +7,10 @@
 
 Kode 是一个强大的 AI 助手，运行在你的终端中。它能理解你的代码库、编辑文件、运行命令，并为你处理整个开发工作流。
 
+> **⚠️ 安全提示**：Kode 默认以 YOLO 模式运行（等同于 Claude 的 `--dangerously-skip-permissions` 标志），跳过所有权限检查以获得最大生产力。YOLO 模式仅建议在安全可信的环境中处理非重要项目时使用。如果您正在处理重要文件或使用能力存疑的模型，我们强烈建议使用 `kode --safe` 启用权限检查和手动审批所有操作。
+> 
+> **📊 模型性能建议**：为获得最佳体验，建议使用专为自主任务完成设计的新一代强大模型。避免使用 GPT-4o、Gemini 2.5 Pro 等较老的问答型模型，它们主要针对回答问题进行优化，而非持续的独立任务执行。请选择专门训练用于智能体工作流和扩展推理能力的模型。
+
 ## 功能特性
 
 - 🤖 **AI 驱动的助手** - 使用先进的 AI 模型理解并响应你的请求
@@ -21,6 +25,20 @@ Kode 是一个强大的 AI 助手，运行在你的终端中。它能理解你
 
 ## 安装
 
+### 推荐方式：使用 Bun（最快）
+
+首先安装 Bun（如果尚未安装）：
+```bash
+curl -fsSL https://bun.sh/install | bash
+```
+
+然后安装 Kode：
+```bash
+bun add -g @shareai-lab/kode
+```
+
+### 备选方式：使用 npm
+
 ```bash
 npm install -g @shareai-lab/kode
 ```
@@ -50,6 +68,52 @@ kode -p "解释这个函数" main.js
 kwa -p "解释这个函数" main.js
 ```
 
+### Docker 使用说明
+ 
+```bash
+# 克隆仓库
+git clone https://github.com/shareAI-lab/Kode.git
+cd Kode
+
+# 本地构建镜像
+docker build --no-cache -t kode .
+
+# 在你的项目目录中运行
+cd your-project
+docker run -it --rm \
+  -v $(pwd):/workspace \
+  -v ~/.kode:/root/.kode \
+  -v ~/.kode.json:/root/.kode.json \
+  -w /workspace \
+  kode
+```
+
+#### Docker 配置详情
+
+该 Docker 配置包含以下内容：
+
+* **卷挂载（Volume Mounts）**：
+
+  * `$(pwd):/workspace` - 挂载当前项目目录
+  * `~/.kode:/root/.kode` - 在运行间保留 kode 配置目录
+  * `~/.kode.json:/root/.kode.json` - 在运行间保留 kode 全局配置文件
+
+* **工作目录**：容器内工作目录设置为 `/workspace`
+
+* **交互模式**：使用 `-it` 标志以交互式终端方式运行
+
+* **清理**：使用 `--rm` 在退出后自动删除容器
+
+**注意**：
+Kode 同时使用 `~/.kode` 目录（存放额外数据，如内存文件）和 `~/.kode.json` 文件（全局配置）。
+
+第一次运行 Docker 命令时会构建镜像，之后的运行会使用缓存镜像以加快启动速度。
+
+你可以通过引导流程（onboarding）来设置模型，或使用 `/model` 命令。
+如果在列表中没有你想要的模型，可以在 `/config` 中手动设置。
+只要你有一个 OpenAI 风格的 API 端点，就可以正常使用。
+
+
 ### 常用命令
 
 - `/help` - 显示可用命令
@@ -243,4 +307,4 @@ ISC 许可证 - 详见 [LICENSE](LICENSE)。
 
 - 📚 [文档](docs/)
 - 🐛 [报告问题](https://github.com/shareAI-lab/kode/issues)
-- 💬 [讨论](https://github.com/shareAI-lab/kode/discussions)
+- 💬 [讨论](https://github.com/shareAI-lab/kode/discussions)

package/cli.js

@@ -32,24 +32,19 @@ try {
 }
 
 function runWithNode() {
-  // Use node with tsx loader
-  const child = spawn('node', [
-    '--loader', 'tsx',
-    '--no-warnings',
-    cliPath,
-    ...args
-  ], {
+  // Use local tsx installation
+  const tsxPath = path.join(__dirname, 'node_modules', '.bin', 'tsx');
+  const child = spawn(tsxPath, [cliPath, ...args], {
     stdio: 'inherit',
     env: {
       ...process.env,
-      NODE_OPTIONS: '--loader tsx --no-warnings',
       YOGA_WASM_PATH: path.join(__dirname, 'yoga.wasm')
     }
   });
   
   child.on('error', (err) => {
-    if (err.code === 'MODULE_NOT_FOUND' || err.message.includes('tsx')) {
-      console.error('\nError: tsx is required but not installed.');
+    if (err.code === 'ENOENT') {
+      console.error('\nError: tsx is required but not found.');
       console.error('Please run: npm install');
       process.exit(1);
     } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shareai-lab/kode",
-  "version": "1.0.71",
+  "version": "1.0.75",
   "bin": {
     "kode": "cli.js",
     "kwa": "cli.js",
@@ -66,9 +66,12 @@
     "env-paths": "^3.0.0",
     "figures": "^6.1.0",
     "glob": "^11.0.3",
+    "gray-matter": "^4.0.3",
     "highlight.js": "^11.11.1",
     "ink": "^5.2.1",
     "ink-link": "^4.1.0",
+    "ink-select-input": "^6.2.0",
+    "ink-text-input": "^6.0.0",
     "lodash-es": "^4.17.21",
     "lru-cache": "^11.1.0",
     "marked": "^15.0.12",
@@ -86,6 +89,7 @@
   },
   "devDependencies": {
     "@types/bun": "latest",
+    "@types/jest": "^30.0.0",
     "@types/node": "^24.1.0",
     "bun-types": "latest",
     "prettier": "^3.6.2",
@@ -109,4 +113,4 @@
     "terminal",
     "command-line"
   ]
-}
+}

package/src/ProjectOnboarding.tsx

@@ -87,6 +87,7 @@ export default function ProjectOnboarding({
       {showOnboarding && (
         <>
           <Text color={theme.secondaryText}>Tips for getting started:</Text>
+          {/* @ts-expect-error - OrderedList children prop issue */}
           <OrderedList>
             {/* Collect all the items that should be displayed */}
             {(() => {
@@ -94,51 +95,66 @@ export default function ProjectOnboarding({
 
               if (isWorkspaceDirEmpty) {
                 items.push(
-                  <OrderedList.Item key="workspace">
-                    <Text color={theme.secondaryText}>
-                      Ask {PRODUCT_NAME} to create a new app or clone a
-                      repository.
-                    </Text>
-                  </OrderedList.Item>,
+                  <React.Fragment key="workspace">
+                    {/* @ts-expect-error - OrderedList.Item children prop issue */}
+                    <OrderedList.Item>
+                      <Text color={theme.secondaryText}>
+                        Ask {PRODUCT_NAME} to create a new app or clone a
+                        repository.
+                      </Text>
+                    </OrderedList.Item>
+                  </React.Fragment>,
                 )
               }
               if (needsClaudeMd) {
                 items.push(
-                  <OrderedList.Item key="claudemd">
-                    <Text color={theme.secondaryText}>
-                      Run <Text color={theme.text}>/init</Text> to create
+                  <React.Fragment key="claudemd">
+                    {/* @ts-expect-error - OrderedList.Item children prop issue */}
+                    <OrderedList.Item>
+                      <Text color={theme.secondaryText}>
+                        Run <Text color={theme.text}>/init</Text> to create
                       a&nbsp;
                       {PROJECT_FILE} file with instructions for {PRODUCT_NAME}.
                     </Text>
-                  </OrderedList.Item>,
+                    </OrderedList.Item>
+                  </React.Fragment>,
                 )
               }
 
               if (showTerminalTip) {
                 items.push(
-                  <OrderedList.Item key="terminal">
-                    <Text color={theme.secondaryText}>
-                      Run <Text color={theme.text}>/terminal-setup</Text>
-                      <Text bold={false}> to set up terminal integration</Text>
-                    </Text>
-                  </OrderedList.Item>,
+                  <React.Fragment key="terminal">
+                    {/* @ts-expect-error - OrderedList.Item children prop issue */}
+                    <OrderedList.Item>
+                      <Text color={theme.secondaryText}>
+                        Run <Text color={theme.text}>/terminal-setup</Text>
+                        <Text bold={false}> to set up terminal integration</Text>
+                      </Text>
+                    </OrderedList.Item>
+                  </React.Fragment>,
                 )
               }
 
               items.push(
-                <OrderedList.Item key="questions">
-                  <Text color={theme.secondaryText}>
-                    Ask {PRODUCT_NAME} questions about your codebase.
-                  </Text>
-                </OrderedList.Item>,
+                <React.Fragment key="questions">
+                  {/* @ts-expect-error - OrderedList.Item children prop issue */}
+                  <OrderedList.Item>
+                    <Text color={theme.secondaryText}>
+                      Ask {PRODUCT_NAME} questions about your codebase.
+                    </Text>
+                  </OrderedList.Item>
+                </React.Fragment>,
               )
 
               items.push(
-                <OrderedList.Item key="changes">
-                  <Text color={theme.secondaryText}>
-                    Ask {PRODUCT_NAME} to implement changes to your codebase.
-                  </Text>
-                </OrderedList.Item>,
+                <React.Fragment key="changes">
+                  {/* @ts-expect-error - OrderedList.Item children prop issue */}
+                  <OrderedList.Item>
+                    <Text color={theme.secondaryText}>
+                      Ask {PRODUCT_NAME} to implement changes to your codebase.
+                    </Text>
+                  </OrderedList.Item>
+                </React.Fragment>,
               )
 
               return items
@@ -159,9 +175,11 @@ export default function ProjectOnboarding({
             </Box>
             <Box flexDirection="column" marginLeft={1}>
               {releaseNotesToShow.map((note, noteIndex) => (
-                <Text key={noteIndex} color={getTheme().secondaryText}>
-                  • {note}
-                </Text>
+                <React.Fragment key={noteIndex}>
+                  <Text color={getTheme().secondaryText}>
+                    • {note}
+                  </Text>
+                </React.Fragment>
               ))}
             </Box>
           </Box>

package/src/Tool.ts

@@ -1,11 +1,42 @@
 import { z } from 'zod'
-import { UUID } from 'crypto'
 import * as React from 'react'
 
+// DEPRECATED: Use domain/tool/Tool.interface.ts for new implementations
+// This interface will be maintained for compatibility during transition
+
+export type SetToolJSXFn = (jsx: {
+  jsx: React.ReactNode | null
+  shouldHidePromptInput: boolean
+} | null) => void
+
 export interface ToolUseContext {
-  messageId: UUID
+  messageId: string | undefined
   agentId?: string
   safeMode?: boolean
+  abortController: AbortController
+  readFileTimestamps: { [filePath: string]: number }
+  options?: {
+    commands?: any[]
+    tools?: any[]
+    verbose?: boolean
+    slowAndCapableModel?: string
+    safeMode?: boolean
+    forkNumber?: number
+    messageLogName?: string
+    maxThinkingTokens?: any
+    isKodingRequest?: boolean
+    kodingContext?: string
+    isCustomCommand?: boolean
+  }
+  // GPT-5 Responses API state management
+  responseState?: {
+    previousResponseId?: string
+    conversationId?: string
+  }
+}
+
+export interface ExtendedToolUseContext extends ToolUseContext {
+  setToolJSX: SetToolJSXFn
 }
 
 export interface ValidationResult {
@@ -49,5 +80,3 @@ export interface Tool<
     unknown
   >
 }
-
-export type { ToolUseContext, ValidationResult }