agkan 1.6.0 → 2.1.0

package/README.ja.md

@@ -17,6 +17,12 @@ TypeScriptで実装された軽量なCLIタスク管理ツールです。エー
 - **ブロック関係**: タスク間の依存関係を管理（循環参照検出機能付き）
 - **タグ機能**: タスクにタグを付けて分類・検索が可能
 
+## Agent Skills
+
+agkanをClaude Codeのスキル（タスクの自動実行、プランニング、レビューなど）と連携して使用するには、以下のスキルパッケージをインストールしてください：
+
+- **[agkan-skills](https://github.com/gendosu/agkan-skills)** - agkanタスク管理用のClaude Codeスキル
+
 ## インストール
 
 ### 前提条件
@@ -193,34 +199,34 @@ agkan task delete 1
 
 タグを作成:
 ```bash
-agkan task tag add "frontend"
+agkan tag add "frontend"
 ```
 
 タグ一覧を表示:
 ```bash
-agkan task tag list
+agkan tag list
 ```
 
 タグを削除:
 ```bash
-agkan task tag delete "frontend"
+agkan tag delete "frontend"
 ```
 
 ### タスクへのタグ付け
 
 タスクにタグを付与:
 ```bash
-agkan task tag attach 1 "frontend"
+agkan tag attach 1 "frontend"
 ```
 
 タスクからタグを削除:
 ```bash
-agkan task tag detach 1 "frontend"
+agkan tag detach 1 "frontend"
 ```
 
 タスクに付けられたタグを表示:
 ```bash
-agkan task tag show 1
+agkan tag show 1
 ```
 
 ### メタデータの管理
@@ -545,7 +551,7 @@ agkan task count --status in_progress --json
 
 JSON出力フォーマット:
 ```bash
-agkan task tag list --json
+agkan tag list --json
 ```
 
 ```json
@@ -570,7 +576,7 @@ agkan task tag list --json
 
 JSON出力フォーマット:
 ```bash
-agkan task tag show 1 --json
+agkan tag show 1 --json
 ```
 
 ```json
@@ -687,21 +693,21 @@ agkan task block remove 1 2
 
 ```bash
 # タグを作成
-agkan task tag add "frontend"
-agkan task tag add "backend"
-agkan task tag add "urgent"
+agkan tag add "frontend"
+agkan tag add "backend"
+agkan tag add "urgent"
 
 # タスクを作成してタグを付与
 agkan task add "ログイン画面の実装"
 # 出力: Task created with ID: 1
 
-agkan task tag attach 1 "frontend"
-agkan task tag attach 1 "urgent"
+agkan tag attach 1 "frontend"
+agkan tag attach 1 "urgent"
 
 agkan task add "API開発"
 # 出力: Task created with ID: 2
 
-agkan task tag attach 2 "backend"
+agkan tag attach 2 "backend"
 
 # タグでフィルタリング
 agkan task list --tag "frontend"
@@ -709,17 +715,17 @@ agkan task list --tag "frontend"
 # 1 [backlog] ログイン画面の実装 (tags: frontend, urgent)
 
 # タスクのタグを確認
-agkan task tag show 1
+agkan tag show 1
 # 出力:
 # Tags for task 1:
 #   - frontend
 #   - urgent
 
 # タグを削除
-agkan task tag detach 1 "urgent"
+agkan tag detach 1 "urgent"
 
 # タグ自体を削除（関連するすべてのタスクから削除される）
-agkan task tag delete "urgent"
+agkan tag delete "urgent"
 ```
 
 ## タスクステータス

package/README.md

@@ -16,6 +16,13 @@ A lightweight CLI task management tool implemented in TypeScript. Optimized for
 - **Parent-Child Relationships**: Manage task hierarchy (tree view supported)
 - **Blocking Relationships**: Manage task dependencies (includes circular reference detection)
 - **Tag System**: Classify and search tasks with tags
+- **Kanban Board**: Local web-based Kanban board viewer
+
+## Agent Skills
+
+To use agkan with Claude Code skills (automated task execution, planning, review, etc.), install the companion skills package:
+
+- **[agkan-skills](https://github.com/gendosu/agkan-skills)** - Claude Code skills for agkan task management
 
 ## Installation
 
@@ -351,22 +358,22 @@ agkan task delete 1
 
 Create a tag:
 ```bash
-agkan task tag add "frontend"
+agkan tag add "frontend"
 ```
 
 List all tags:
 ```bash
-agkan task tag list
+agkan tag list
 ```
 
 Delete a tag:
 ```bash
-agkan task tag delete "frontend"
+agkan tag delete "frontend"
 ```
 
 JSON output format for tag list:
 ```bash
-agkan task tag list --json
+agkan tag list --json
 ```
 
 ```json
@@ -393,22 +400,22 @@ agkan task tag list --json
 
 Attach a tag to a task:
 ```bash
-agkan task tag attach 1 "frontend"
+agkan tag attach 1 "frontend"
 ```
 
 Remove a tag from a task:
 ```bash
-agkan task tag detach 1 "frontend"
+agkan tag detach 1 "frontend"
 ```
 
 Display tags on a task:
 ```bash
-agkan task tag show 1
+agkan tag show 1
 ```
 
 JSON output format for tag show:
 ```bash
-agkan task tag show 1 --json
+agkan tag show 1 --json
 ```
 
 ```json
@@ -513,6 +520,20 @@ agkan task count --status in_progress --json
 }
 ```
 
+### Kanban Board (Web UI)
+
+Start a local Kanban board viewer in your browser:
+```bash
+agkan board
+```
+
+Specify a custom port:
+```bash
+agkan board -p 3000
+```
+
+The board is served at `http://localhost:8080` by default.
+
 ### Display Help
 
 Show command list:
@@ -687,21 +708,21 @@ Example of classifying tasks with tags:
 
 ```bash
 # Create tags
-agkan task tag add "frontend"
-agkan task tag add "backend"
-agkan task tag add "urgent"
+agkan tag add "frontend"
+agkan tag add "backend"
+agkan tag add "urgent"
 
 # Create tasks and attach tags
 agkan task add "Implement login screen"
 # Output: Task created with ID: 1
 
-agkan task tag attach 1 "frontend"
-agkan task tag attach 1 "urgent"
+agkan tag attach 1 "frontend"
+agkan tag attach 1 "urgent"
 
 agkan task add "API development"
 # Output: Task created with ID: 2
 
-agkan task tag attach 2 "backend"
+agkan tag attach 2 "backend"
 
 # Filter by tag
 agkan task list --tag "frontend"
@@ -709,17 +730,17 @@ agkan task list --tag "frontend"
 # 1 [backlog] Implement login screen (tags: frontend, urgent)
 
 # Display task tags
-agkan task tag show 1
+agkan tag show 1
 # Output:
 # Tags for task 1:
 #   - frontend
 #   - urgent
 
 # Remove a tag
-agkan task tag detach 1 "urgent"
+agkan tag detach 1 "urgent"
 
 # Delete a tag (removes from all associated tasks)
-agkan task tag delete "urgent"
+agkan tag delete "urgent"
 ```
 
 ## Task Statuses
@@ -887,6 +908,7 @@ For detailed information about planned features, see [docs/planned-features.md](
 - **CLI Framework**: Commander.js
 - **Database**: SQLite3 (better-sqlite3)
 - **Terminal Display**: Chalk
+- **Web Server**: Hono (for Kanban board viewer)
 - **Build Tool**: TypeScript Compiler
 
 ## Project Structure
@@ -914,6 +936,7 @@ agkan/
 │   │   │   │   ├── detach.ts
 │   │   │   │   ├── list.ts
 │   │   │   │   └── show.ts
+│   │   │   ├── board.ts             # Kanban board command
 │   │   │   └── task/                # Task commands
 │   │   │       ├── add.ts
 │   │   │       ├── count.ts
@@ -925,6 +948,8 @@ agkan/
 │   │   │       └── update.ts
 │   │   ├── utils/                   # CLI utilities
 │   │   └── index.ts                 # CLI entry point and command registration
+│   ├── board/
+│   │   └── server.ts                # Kanban board web server (Hono)
 │   ├── db/
 │   │   ├── config.ts                # DB configuration
 │   │   ├── connection.ts            # Database connection management

package/dist/board/server.d.ts

@@ -0,0 +1,8 @@
+import { Hono } from 'hono';
+import { TaskService } from '../services/TaskService';
+import { TaskTagService } from '../services/TaskTagService';
+import { MetadataService } from '../services/MetadataService';
+import { StorageProvider } from '../db/types/storage';
+export declare function createBoardApp(taskService?: TaskService, taskTagService?: TaskTagService, metadataService?: MetadataService, db?: StorageProvider): Hono;
+export declare function startBoardServer(port: number): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/board/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/board/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAK9D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA+hBtD,wBAAgB,cAAc,CAC5B,WAAW,CAAC,EAAE,WAAW,EACzB,cAAc,CAAC,EAAE,cAAc,EAC/B,eAAe,CAAC,EAAE,eAAe,EACjC,EAAE,CAAC,EAAE,eAAe,GACnB,IAAI,CA0IN;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMnD"}