open-index/open-npm huggingface dataset:
npm package: @fy-npm/codekanban-test
Description: An auxiliary programming tool for the AI era, helping you speed up 10x.
Author: fy0
Latest version: 0.0.5

<div align="center">

# 代码看板 Code kanban

AI时代的辅助编程工具，帮助你提速10倍。

![Go](https://img.shields.io/badge/Go-1.24+-00ADD8?logo=go)
![Vue](https://img.shields.io/badge/Vue-3.5-4FC08D?logo=vue.js)
![TypeScript](https://img.shields.io/badge/TypeScript-5.8-3178C6?logo=typescript)
![License](https://img.shields.io/badge/license-Apache--2.0-green)

[中文](README.zh-CN.md) | [English](README.md)

[核心特性](#核心特性) • [快速体验](#快速体验) • [开发指南](#开发指南) • [关于](#关于)

![预览图](docs/preview.png)

</div>

## 快速体验

立即试用：

```bash
npx @fy-npm/codekanban-test
# 或
npm install -g @fy-npm/codekanban-test
```

## 核心特性

- **开箱即用**: 单文件，本地数据库，双击即可使用
- **多项目多终端管理**：轻松在 3-4 个代码仓库、二十几个终端之间切换，每个终端运行不同的 AI 编程任务
- **Git Worktree 管理**：轻量级分支管理，同时让 AI 开发多个功能，不满意随时回滚
- **任务看板**：可视化管理开发任务，支持任务状态跟踪和分支关联
- **Web 终端集成**：使用VSC同款技术栈的 Web 终端，支持标签管理、拖动排序、折叠展开等 (快捷键`)
- **笔记功能**：支持多标签笔记，自动保存，标签可重命名和排序 (快捷键1)
- **编辑器集成**：快捷打开 VSCode、Cursor、Zed 等编辑器
- **使用你喜欢的工具**: Claude Code, Codex, Gemini, Qwen Code, Droid, ... 啥都行

Tips: 中文用户注意，搜狗输入法在 ClaudeCode 中兼容性不佳，在VSCode中表现也是大差不差的。不过alt+v仍然可以粘贴图片。

## 开发指南

### 环境要求
- **Node.js**: v20.19.0+ 或 v22.12.0+
- **Go**: 1.24.6+
- **包管理器**: pnpm（推荐）

### 安装依赖

**前端依赖**：
```bash
cd ui
pnpm install
```

**后端依赖**：
```bash
go mod tidy
```

### 开发运行

**前端开发服务器**：
```bash
cd ui
pnpm dev
```
访问地址：`http://localhost:5173`

**后端开发服务器**：
```bash
go run . # 注意，初次运行后会生成config.yaml，端口3007，由于跟正式版本冲突，无法同时运行，建议改为3005。以下当作已经修改
```
- 服务端口：`http://localhost:3005`
- OpenAPI 文档：`http://localhost:3005/docs`
- 健康检查：`http://localhost:3005/api/v1/health`

**可选参数**：
- `-m` 或 `--migrate`：强制执行数据库迁移
- `-i` 或 `--install`：安装为系统服务
- `--uninstall`：卸载系统服务

### 生产构建

**完整构建**（推荐）：
```bash
python build.py
```
此脚本会自动完成以下步骤：
1. 构建前端（`pnpm build`）
2. 将前端产物复制到 `static/` 目录
3. 构建 Go 可执行文件（带优化）

**手动构建**：
```bash
# 构建前端
cd ui && pnpm build

# 构建后端
go build -ldflags="-s -w" -trimpath -o CodeKanban
```

**构建产物**：
- 前端：`ui/dist/` → `static/` (移动到此目录后，构建后端会自动存入可执行文件，实现单文件启动)
- 后端：`CodeKanban.exe`（Windows）或 `CodeKanban`（Linux/macOS）

### 访问应用

**开发环境**：
- 前端开发服务器：`http://localhost:5173`
- 后端 API：`http://localhost:3005`

**生产环境**：
运行构建后的可执行文件，访问 `http://localhost:3007`

## 关于

我们处在一个日新月异也异常撕裂的时代，我们的作品也是如此。

这个工具切实的提升了我的效率，但也许效率的提升也会减少工作需求，而AI的发展会消灭这个行业。

不管怎么说，希望大家用的开心。

如果有帮到你，可以点点star或者给我一点赞助。


### 未来可能的一些功能
- 移动端支持
- 代码清理: 如前端的src/api，应当全走自动生成
- 完成提醒功能，例如AI干完之后播放个声音，告诉你已经弄好了。
- 空闲终端列表 / 待交互终端列表。