npm - @hncode/hncode - Versions diffs - 0.1.7 → 0.1.9 - Mend

@hncode/hncode 0.1.7 → 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -1,198 +1,87 @@
-# hncode — AI Coding Agent CLI
-English | [简体中文](./README_CN.md)
-> **This is a product of my Vibe Coding session. It may not be perfect, but if you have any suggestions, feel free to open an issue.**
-A cyan-blue TUI coding agent inspired by [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code), with OpenAI + Anthropic support, MCP-style toolbelt, and intelligent context management.
----
-## 🌟 Features
-- **Cyan-blue TUI**: Raw terminal renderer for perfect Windows Terminal compatibility
-- **Dual Protocol Support**: Works with both OpenAI-compatible APIs and Anthropic
-- **Smart Context Management**: Auto-compaction at 85% usage, AI-summarized history retention
-- **MCP-style Toolbelt**: Read, Write, Edit, Bash, Glob, Grep, TodoList, WebSearch, etc.
-- **Plugin System**: Extend with custom tools, commands, and hooks
-- **Session Persistence**: Resume conversations across sessions
-- **Permission Modes**: Ask, YOLO, or Auto modes for different workflows
----
-## 🚀 Installation
-### Global Installation (Recommended)
-```bash
-npm install -g @hncode/hncode
-```
-Then run:
-```bash
-hncode
-```
-### Using npx (No installation required)
-```bash
-npx @hncode/hncode
-```
-This will download and run the latest version without installing it globally.
----
-## ⚙️ Configuration
-Create `~/.hncode/config.toml`:
-```toml
-default_model = "gpt-4o-mini"
-[providers.openai]
-base_url = "https://api.openai.com/v1"
-api_key = "your-api-key-here"
-[models.gpt-4o-mini]
-provider = "openai"
-model = "gpt-4o-mini"
-```
-Or set environment variables:
-```bash
-export HNCODE_API_KEY="your-key"
-export HNCODE_PROVIDER="openai"
-export HNCODE_MODEL="gpt-4o-mini"
-```
----
-## 📖 Usage
-### Basic Commands
-| Command | Description |
-|---------|-------------|
-| `/compact [ratio]` | Compact conversation (AI summary + keep last 20%) |
-| `/model <name>` | Switch LLM model |
-| `/sessions` | Browse and resume past conversations |
-| `/move <path>` | Move current session to another directory |
-| `/auto` / `/ask` / `/yolo` | Toggle permission mode |
-| `/plan` / `/focus` | Toggle research-only or full-edit mode |
-| `/calm-mode` | Terse replies (skip narration) |
-| `/help` | Show all commands |
-### Tab Completion
-- Type `/` → command menu
-- Type `@` → file/folder completion
-- Use Tab to navigate, Enter to select
-### Auto Compaction
-- Triggers automatically when context usage reaches 85%
-- AI summarizes dropped messages instead of simply deleting them
-- Keeps the most recent 20% of conversation to maintain context coherence
----
-## 🔧 Plugin System
-### Creating Plugins
-Create `.js` or `.mjs` files in `~/.hncode/plugins/`:
-```javascript
-// my-plugin.mjs
-export function install(api) {
-  // Register new tool
-  api.registerTool({
-    name: 'MyTool',
-    description: '...',
-    parameters: { /* schema */ },
-    async execute(args, ctx) { return result; }
-  });
-  // Register command
-  api.registerCommand({
-    name: 'mycmd',
-    description: '...',
-    run: (arg, ctx) => { /* ... */ }
-  });
-  // Register hook
-  api.registerHook('onTurnEnd', (turnInfo) => { /* ... */ });
-}
-export default { name: 'my-plugin', version: '1.0.0' };
-```
-### View Loaded Plugins
-```bash
-hncode /plugins
-```
----
-## 🛠 Tools
-Built-in tools include:
-- `Read`, `Write`, `Edit` - File operations
-- `Bash` - Execute shell commands
-- `Glob`, `Grep` - Search files
-- `TodoList`, `TaskOutput` - Task management
-- `FetchURL`, `WebSearch` - Internet access
-- `ReadMediaFile`, `FileLines` - Media handling
----
-## 🎨 Themes
-Supported themes: `auto`, `dark`, `light`, or custom RGB colors.
-Set via config:
-```toml
-theme = "dark"
-```
-Or use `/theme <name>` in TUI.
----
-## 🤝 Contributing
-This project was created through Vibe Coding. While it may not be perfect, I welcome your feedback!
-**Feel free to:**
-- Submit issues for bugs or suggestions
-- Fork and create pull requests
-- Share your experience using hncode
----
-## 🙏 Acknowledgments
-hncode draws inspiration from several excellent projects:
-- **[Kimi Code CLI](https://github.com/MoonshotAI/kimi-code)** - The original cyan-blue TUI coding agent that inspired this project's design and approach
-- **[Claude Code](https://github.com/anthropics/claude-code)** - The conversation flow and tool interaction patterns
-Special thanks to the communities behind these projects for pushing the boundaries of AI-assisted coding.
----
-## 📄 License
-This project is licensed under the [GNU General Public License v3.0](LICENSE).
-**In short:**
-1. ✅ You can freely use, modify, and share this code
-2. ✅ Must retain author attribution (NiceHello666) and link back to this repository
-3. ❌ Cannot be used for commercial purposes (e.g., selling, as part of paid products)
----
-**NPM Package**: [@hncode/hncode](https://www.npmjs.com/package/@hncode/hncode)
-**GitHub**: [NiceHello666/hncode](https://github.com/NiceHello666/hncode)
+# hncode — AI Coding Agent TUI
+English | [简体中文](https://github.com/NiceHello666/hncode/blob/main/README_CN.md) | [Wiki](https://github.com/NiceHello666/hncode/blob/main/README_WIKI.md)
+> **This is a product of my Vibe Coding session. It may not be perfect, but if you have any suggestions, feel free to open an issue.**
+A cyan-blue terminal user interface (TUI) coding agent inspired by [Kimi Code](https://github.com/MoonshotAI/kimi-code), with OpenAI + Anthropic support, an MCP-style toolbelt, and intelligent context management.
+---
+## 🌟 Features
+- **Cyan-blue TUI**: Raw terminal renderer for perfect Windows Terminal compatibility
+- **Dual Protocol Support**: Works with both OpenAI-compatible APIs and Anthropic
+- **Smart Context Management**: Auto-compaction at 85% usage, AI-summarized history retention
+- **MCP-style Toolbelt**: Read, Write, Edit, Bash, Glob, Grep, TodoList, WebSearch, etc.
+- **Plugin System**: Extend with custom tools, commands, and hooks
+- **Session Persistence**: Resume conversations across sessions
+- **Permission Modes**: Ask, YOLO, or Auto modes for different workflows
+---
+## 🚀 Installation
+### Global Installation (Recommended)
+```bash
+npm install -g @hncode/hncode
+```
+Then run:
+```bash
+hncode
+```
+### Using npx (No installation required)
+```bash
+npx @hncode/hncode
+```
+---
+## 📖 Documentation
+This file is a quick overview. For the **full documentation** — every command, config option, architecture notes, and the plugin/development guide — see the Wiki:
+- **[Wiki (English)](https://github.com/NiceHello666/hncode/blob/main/README_WIKI.md)**
+- **[Wiki (简体中文)](https://github.com/NiceHello666/hncode/blob/main/README_WIKI_CN.md)**
+---
+## 🤝 Contributing
+This project was created through Vibe Coding. While it may not be perfect, I welcome your feedback!
+**Feel free to:**
+- Submit issues for bugs or suggestions
+- Fork and create pull requests
+- Share your experience using hncode
+---
+## 🙏 Acknowledgments
+hncode draws inspiration from several excellent projects:
+- **[Kimi Code](https://github.com/MoonshotAI/kimi-code)** - The original cyan-blue TUI coding agent that inspired this project's design and approach
+- **[Claude Code](https://github.com/anthropics/claude-code)** - The conversation flow and tool interaction patterns
+Special thanks to the communities behind these projects for pushing the boundaries of AI-assisted coding.
+---
+## 📄 License
+This project is licensed under the [GNU General Public License v3.0](https://github.com/NiceHello666/hncode/blob/main/LICENSE).
+**In short:**
+1. ✅ You can freely use, modify, and share this code
+2. ✅ Must retain author attribution (NiceHello666) and link back to this repository
+3. ❌ Cannot be used for commercial purposes (e.g., selling, as part of paid products)
+---
+**NPM Package**: [@hncode/hncode](https://www.npmjs.com/package/@hncode/hncode)
+**GitHub**: [NiceHello666/hncode](https://github.com/NiceHello666/hncode)

package/README_CN.md CHANGED Viewed

@@ -1,187 +1,87 @@
-# hncode — AI 编程助手命令行工具
-[English](./README.md) | 简体中文
-> **这是我 Vibe Coding 的产物，可能不是特别好，但是如果有什么建议的话也欢迎提 issue**
-一个基于命令行终端的 AI 编程助手，灵感源自 [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code)。它提供青色蓝调 (Cyan-blue) 的 TUI 界面，支持 OpenAI 和 Anthropic 双协议，配备 MCP 风格的工具集和智能上下文管理。
-## 🌟 核心特性
-- **原生 TUI 渲染**: 使用原始终端序列号渲染，完美兼容 Windows Terminal，解决 blessed 等库在 Windows 上的兼容性问题
-- **双协议支持**: 同时支持 OpenAI-compatible API 和 Anthropic API
-- **智能上下文管理**:
-  - 85% 使用率时自动触发压缩
-  - AI 摘要保留的历史对话，而非简单丢弃
-  - 手动 `/compact` 命令支持自定义压缩比例
-- **MCP 风格工具集**: Read, Write, Edit, Bash, Glob, Grep, TodoList, WebSearch, FetchURL 等
-- **插件系统**: 可扩展的工具、命令和生命周期钩子
-- **会话持久化**: 跨会话恢复对话
-- **权限模式**: Ask, YOLO, Auto 三种工作流模式
-## 🚀 安装
-### 全局安装（推荐）
-```bash
-npm install -g @hncode/hncode
-```
-然后运行：
-```bash
-hncode
-```
-### 使用 npx（无需安装）
-```bash
-npx @hncode/hncode
-```
-这将下载并运行最新版本，而无需全局安装。
-### 本地开发安装
-```bash
-npm install @hncode/hncode
-```
-## ⚙️ 配置
-创建 `~/.hncode/config.toml`:
-```toml
-default_model = "gpt-4o-mini"
-[providers.openai]
-base_url = "https://api.openai.com/v1"
-api_key = "your-api-key-here"
-[models.gpt-4o-mini]
-provider = "openai"
-model = "gpt-4o-mini"
-```
-或使用环境变量:
-```bash
-export HNCODE_API_KEY="your-key"
-export HNCODE_PROVIDER="openai"
-export HNCODE_MODEL="gpt-4o-mini"
-```
-## 📖 使用
-### 基本命令
-| 命令 | 描述 |
-|------|------|
-| `/compact [ratio]` | 压缩对话（AI 摘要 + 保留最近 20%） |
-| `/model <name>` | 切换 LLM 模型 |
-| `/sessions` | 浏览和恢复过往对话 |
-| `/move <path>` | 将当前会话迁移到另一个目录 |
-| `/auto` / `/ask` / `/yolo` | 切换权限模式 |
-| `/plan` / `/focus` | 切换仅研究或完整编辑模式 |
-| `/calm-mode` | 简洁回复（跳过叙述） |
-| `/help` | 显示所有命令 |
-### Tab 补全
-- 输入 `/` → 命令菜单
-- 输入 `@` → 文件/文件夹补全
-- 使用 Tab 导航，Enter 选择
-### 自动压缩
-- 当上下文使用率达到 85% 时自动触发
-- AI 会摘要被丢弃的消息，而不是简单删除
-- 保留最近的 20% 对话以保持上下文连贯性
-## 🔧 插件系统
-### 创建插件
-在 `~/.hncode/plugins/` 目录下创建 `.js` 或 `.mjs` 文件：
-```javascript
-// my-plugin.mjs
-export function install(api) {
-  // 注册新工具
-  api.registerTool({
-    name: 'MyTool',
-    description: '...',
-    parameters: { /* schema */ },
-    async execute(args, ctx) { return result; }
-  });
-  // 注册命令
-  api.registerCommand({
-    name: 'mycmd',
-    description: '...',
-    run: (arg, ctx) => { /* ... */ }
-  });
-  // 注册钩子
-  api.registerHook('onTurnEnd', (turnInfo) => { /* ... */ });
-}
-export default { name: 'my-plugin', version: '1.0.0' };
-```
-### 查看已加载插件
-```bash
-hncode /plugins
-```
-## 🛠 工具集
-内置工具包括：
-- `Read`, `Write`, `Edit` - 文件操作
-- `Bash` - 执行 Shell 命令
-- `Glob`, `Grep` - 搜索文件
-- `TodoList`, `TaskOutput` - 任务管理
-- `FetchURL`, `WebSearch` - 网络访问
-- `ReadMediaFile`, `FileLines` - 媒体处理
-## 🎨 主题
-支持的 theme: `auto`, `dark`, `light`, 或自定义 RGB 颜色。
-通过配置设置:
-```toml
-theme = "dark"
-```
-或在 TUI 中使用 `/theme <name>`。
-## 🤝 贡献
-这个项目是通过 Vibe Coding 创建的。虽然它可能不够完美，但我欢迎您的反馈！
-**欢迎：**
-- 提交问题报告 bug 或提出建议
-- Fork 并创建拉取请求
-- 分享您使用 hncode 的体验
-## 🙏 致谢
-hncode 从以下几个优秀项目中汲取了灵感：
-- **[Kimi Code CLI](https://github.com/MoonshotAI/kimi-code)** - 原始的青色蓝调终端界面 AI 编程助手，启发了本项目的设计和理念
-- **[Claude Code](https://github.com/anthropics/claude-code)** - 对话流程和工具交互模式
-特别感谢这些项目背后的社区，它们推动了 AI 辅助编程的边界。
-## 📄 许可证
-本项目的许可受 [GNU General Public License v3.0](LICENSE) 保护。
-**简单来说:**
-1. ✅ 你可以自由使用、修改和分享此代码
-2. ✅ 必须保留原作者署名（NiceHello666）并链接回此仓库
-3. ❌ 不得用于商业目的（例如出售、作为付费产品的一部分）
----
-**NPM 包**: [@hncode/hncode](https://www.npmjs.com/package/@hncode/hncode)
-**GitHub**: [NiceHello666/hncode](https://github.com/NiceHello666/hncode)
+# hncode — AI 编程助手 TUI
+[English](https://github.com/NiceHello666/hncode/blob/main/README.md) | 简体中文 | [Wiki](https://github.com/NiceHello666/hncode/blob/main/README_WIKI_CN.md)
+> **这是我 Vibe Coding 的产物，可能不是特别好，但是如果有什么建议的话也欢迎提 issue**
+一个基于终端用户界面（TUI）的 AI 编程助手，灵感源自 [Kimi Code](https://github.com/MoonshotAI/kimi-code)。它提供青色蓝调 (Cyan-blue) 的 TUI 界面，支持 OpenAI 和 Anthropic 双协议，配备 MCP 风格的工具集和智能上下文管理。
+---
+## 🌟 核心特性
+- **原生 TUI 渲染**: 使用原始终端序列渲染，完美兼容 Windows Terminal，解决 blessed 等库在 Windows 上的兼容性问题
+- **双协议支持**: 同时支持 OpenAI-compatible API 和 Anthropic API
+- **智能上下文管理**: 85% 使用率时自动压缩，AI 摘要保留历史对话
+- **MCP 风格工具集**: Read, Write, Edit, Bash, Glob, Grep, TodoList, WebSearch, FetchURL 等
+- **插件系统**: 可扩展的工具、命令和生命周期钩子
+- **会话持久化**: 跨会话恢复对话
+- **权限模式**: Ask, YOLO, Auto 三种工作流模式
+---
+## 🚀 安装
+### 全局安装（推荐）
+```bash
+npm install -g @hncode/hncode
+```
+然后运行：
+```bash
+hncode
+```
+### 使用 npx（无需安装）
+```bash
+npx @hncode/hncode
+```
+---
+## 📖 文档
+本文件只是简要介绍。**完整文档**（所有命令、配置项、架构说明、插件与开发指南）请见 Wiki：
+- **[Wiki（英文）](https://github.com/NiceHello666/hncode/blob/main/README_WIKI.md)**
+- **[Wiki（简体中文）](https://github.com/NiceHello666/hncode/blob/main/README_WIKI_CN.md)**
+---
+## 🤝 贡献
+这个项目是通过 Vibe Coding 创建的。虽然它可能不够完美，但我欢迎您的反馈！
+**欢迎：**
+- 提交问题报告 bug 或提出建议
+- Fork 并创建拉取请求
+- 分享您使用 hncode 的体验
+---
+## 🙏 致谢
+hncode 从以下几个优秀项目中汲取了灵感：
+- **[Kimi Code](https://github.com/MoonshotAI/kimi-code)** - 原始的青色蓝调终端界面 AI 编程助手，启发了本项目的设计和理念
+- **[Claude Code](https://github.com/anthropics/claude-code)** - 对话流程和工具交互模式
+特别感谢这些项目背后的社区，它们推动了 AI 辅助编程的边界。
+---
+## 📄 许可证
+本项目的许可受 [GNU General Public License v3.0](https://github.com/NiceHello666/hncode/blob/main/LICENSE) 保护。
+**简单来说:**
+1. ✅ 你可以自由使用、修改和分享此代码
+2. ✅ 必须保留原作者署名（NiceHello666）并链接回此仓库
+3. ❌ 不得用于商业目的（例如出售、作为付费产品的一部分）
+---
+**NPM 包**: [@hncode/hncode](https://www.npmjs.com/package/@hncode/hncode)
+**GitHub**: [NiceHello666/hncode](https://github.com/NiceHello666/hncode)

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@hncode/hncode",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "hncode — A cyan-blue TUI AI coding agent with zero runtime dependencies.",
   "type": "module",
   "main": "src/index.js",

package/src/agent.js CHANGED Viewed

@@ -24,35 +24,26 @@ export function nudgeMessage(why) {
 // Final instruction appended to the system prompt (see SYSTEM_PROMPT).
 // (The wording lives in SYSTEM_PROMPT itself, under "Finishing a turn".)
-export const SYSTEM_PROMPT = `You are hncode, a coding agent running. You must monitor your context usage. When you detect that you're approaching the context limit (see your last messages about token counts), you should proactively call /compact to reduce the conversation history. in the user's terminal on ${process.platform}.
-You operate inside a workspace directory. You can inspect files, edit code, run commands, and track tasks using the tools available.
+export const SYSTEM_PROMPT = `You are hncode, a coding agent in the user's terminal on ${process.platform}.
+You work inside a workspace directory using the tools provided.
 Tools:
+- Read a file before editing it; never guess contents or edit code you haven't read.
 - Prefer Edit over Write for existing files.
-- Read before you edit; never guess file contents. Never propose changes to code you haven't read.
-- If a tool fails, diagnose why before switching tactics. Read the error; don't guess.
-  After 2 failed attempts on the same goal, STOP and report the blocker.
-- Independent tool calls can run in parallel, but never parallelize calls with dependencies.
+- If a tool fails, read the error and fix your approach. After 2 failed attempts on the same goal, stop and report the blocker.
+- Independent tool calls may run in parallel; never parallelize dependent ones.
 Scope:
-- Do what was asked. Do not refactor, rename, or "improve" unrelated code.
-- If the request is ambiguous, ask one short clarifying question before acting.
-- If you make an assumption, state it explicitly.
+- Do only what was asked. Do not refactor or "improve" unrelated code.
+- If the request is ambiguous, ask one short clarifying question.
+- State any assumption you make.
 Finishing:
-- Never stop silently after a tool call.
-- End every turn with a short report in the user's language:
-  Done: what changed (files / commands / result), and how you verified it.
-  Not done: what failed, what you tried, and what you need from the user.
-- Never claim success without evidence. Cite file_path:line_number for any code you
-  reference. If you didn't run a command or read back the file, you don't know it worked.
-- Be brief. No filler, no restating the request.
-- After tools succeed, don't re-explain what the tool did. Report only the outcome.
-Finishing a turn:
-- End every turn with a written answer. Never stop right after a tool call, and never
-  stop with reasoning only: either keep calling tools until the task is done, or write
-  the summary. A turn that ends without an answer is flagged back to you with a reminder.
+- Never stop silently after a tool call; end every turn with a written answer in the user's language.
+- Report briefly: what changed, and how you verified it. If something failed, say what you tried and what you need.
+- Never claim success without evidence. Cite file:line for referenced code.
+- Be concise. No filler, no restating the request or explaining tool output that already spoke for itself.
+- If context is running low, call /compact to shrink history.
 `;
 export class Agent {