Helios Kanban Remote
Remote control Helios Kanban (helios-kanban) via REST API — list/create/update tasks, start/stop coding agents, follow-up, check status, handle approvals. Use when the user wants to control kanban from phone/chat, mentions Helios Kanban / helios-kanban / vibe-kanban remotely, or asks to create tasks, start agents, or check progress on a running instance. If the skill is not installed yet, read and follow INSTALL.md to self-install from GitHub first.
Rank
62
Safety
84
Downloads
2.7k
Updated
Oct 9, 2026
Version
0.1.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2.7K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2.7K downloadsadoption · observed Oct 9, 2026
- Latest release
- 0.1.0release · observed Jul 31, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s1740c8vy7zm5bfwdhwkr9hqhh8bk47a:helios-kanban-skills- Install using `clawhub skill install s1740c8vy7zm5bfwdhwkr9hqhh8bk47a:helios-kanban-skills` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/solomonfang/helios-kanban-skills before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/snapshot"
Documentation
CLAWHUB
25,661 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: helios-kanban-remote
description: >-
Remote control Helios Kanban (helios-kanban) via REST API — list/create/update
tasks, start/stop coding agents, follow-up, check status, handle approvals.
Use when the user wants to control kanban from phone/chat, mentions Helios
Kanban / helios-kanban / vibe-kanban remotely, or asks to create tasks, start
agents, or check progress on a running instance. If the skill is not installed
yet, read and follow INSTALL.md to self-install from GitHub first.
---
# Helios Kanban Remote Control
Control a running [Helios Kanban](https://github.com/SolomonFang/vibe-kanban) instance over HTTP. Designed for chat bots (e.g. Hermes on phone) that can run shell commands or HTTP requests on a host with network access to the kanban server.
## Prerequisites
1. **Helios Kanban running** on a reachable host:
```bash
HOST=0.0.0.0 PORT=7964 npx helios-kanban
```
2. **Network**: bot host can reach the server (Tailscale recommended).
3. **Env vars** (set on the bot host):
- `HELIOS_KANBAN_URL` — base URL, e.g. `http://100.x.x.x:7964`
- `HELIOS_KANBAN_PROJECT_ID` — optional default project UUID
- `HELIOS_KANBAN_REPO_ID` — optional default repo UUID
- `HELIOS_KANBAN_ITERATION` — optional default iteration (e.g. `260717`)
## Quick workflow
| User intent | Action |
|-------------|--------|
| "有哪些项目" | `hk projects`(看 `description` + `repos` 选项目) |
| "创建项目" | `hk projects create "名称" --repo-path /server/abs/path` |
| "默认 agent / 仓库" | `hk info`;`hk repos` |
| "看看进行中的" | `hk tasks list --status inprogress` |
| "找登录相关任务" | `hk tasks list --query 登录` |
| "260717 迭代" | `hk tasks list --iteration 260717` |
| "创建任务" | `hk tasks create "标题" --desc "用 @coding-standards"` |
| "紧急任务" | `hk tasks create "标题" --priority urgent` |
| "看紧急/高优任务" | `hk tasks list --priority urgent` |
| "有哪些分支" | `hk branches <repo_id> [--query develop]` |
| "多仓启动" | `hk start <task_id> --repo <id1> --repo <id2>:develop` |
| "有哪些 tag" | `hk tags` |
| "基于 develop 启动" | `hk start <task_id> --branch develop` |
| "新建并启动" | `hk create-and-start "标题"` |
| "再跟它说一句…" | `hk follow-up <task_id> <prompt>`(运行中自动排队) |
| "跑得怎么样了" | `hk status <task_id>` |
| "有没有待审批" | `hk approvals` → `hk approve/deny … --process <ep_id>` |
| "停掉 agent" | `hk workspaces --task <id>` → `hk stop <workspace_id>` |
| "取消任务" | `hk tasks cancel <task_id>`(会先 stop) |
| "删除任务" | 确认后 → `hk tasks delete <task_id>` |
| "标记完成" | `hk tasks update <task_id> --status done` |
Cache `project_id` / `repo_id` in the conversation. Prefer env defaults so commands stay short.
## Complete lifecycle
```text
1. hk repos / hk branches <repo>
2. hk tasks create "标题" [--iteration CODE] [--priority P]
3. hk start <task_id> [--branch B] [--repo R]
└─ or: hk create-and-start "标题" …
4. hk status <task_id> # progress / diff summary
5. hk follow-up <task_id> <prompt> # continue chatting
6. hk approvals → approve | deny
7a. hk stop <workspace_id>
7b. hk tasks caREADME.md
# Helios Kanban Skills > 这是一个用于 Helios 平台的看板(Kanban)技能/扩展模板(README 模板),包含项目概述、安装、使用示例和贡献说明。请根据你的仓库实际实现替换占位内容。 ## 项目简介 Helios Kanban Skills 是一组用于在 Helios 平台上管理和展示看板(Kanban)相关功能的技能/工具集合。目标是提供直观的看板视图、任务卡片管理、列(lane)操作以及与后端同步的能力,便于在 Helios 环境中快速构建看板式工作流。 > 注:这份 README 是通用模板。请根据仓库中实际的语言、运行方式和接口,替换下面的示例命令与配置示例。 ## 主要功能 - 创建 / 编辑 / 删除 看板与列(lane) - 创建 / 编辑 / 移动 / 删除 任务卡片(card) - 支持多用户协作与权限控制(视实现而定) - 与 Helios 平台或自定义后端同步数据 - 支持导入/导出(CSV/JSON)以及基本统计信息 本项目采用 MIT 许可。详见 LICENSE 文件。 ---
_meta.json
{
"ownerId": "kn7axrc2jv3ec02qw1y5wd160s8bke6s",
"slug": "helios-kanban-skills",
"version": "0.1.0",
"publishedAt": 1785483409606
}examples.md
# Examples ## Setup ```bash export HELIOS_KANBAN_URL="http://100.64.0.5:7964" export HELIOS_KANBAN_PROJECT_ID="a1b2c3d4-e5f6-7890-abcd-ef1234567890" export HELIOS_KANBAN_REPO_ID="bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb" export HELIOS_KANBAN_ITERATION="260717" HK="bash scripts/hk.sh" ``` ## Pick the right project ```bash $HK projects # read description + repos, then: export HELIOS_KANBAN_PROJECT_ID="<chosen>" # or set description for agents: $HK projects update "$HELIOS_KANBAN_PROJECT_ID" --description "Kanban product — UI/API work only" ``` ## Full remote loop **User**: 260717 新建「修复登录」,基于 develop 跑起来 ```bash $HK branches "$HELIOS_KANBAN_REPO_ID" --query develop $HK create-and-start "修复登录" --branch develop --desc "登录页 500 @coding-standards" # or multi-repo: # $HK start "<task_id>" --repo "$REPO_A" --repo "$REPO_B:main" ``` **User**: 怎么样了? ```bash $HK status "<task_id>" # running, last_attempt_failed, workspace summaries (files/lines, pending approval) ``` **User**: 再跟它说加单测 ```bash $HK follow-up "<task_id>" 请补充单元测试并保持 API 兼容 # mode=follow_up | queued ``` **User**: 有审批卡着 ```bash $HK approvals $HK approve "<approval_id>" --process "<execution_process_id>" # or: $HK deny "<approval_id>" --process "<ep_id>" --reason "too risky" ``` **User**: 停掉 / 取消 ```bash $HK workspaces --task "<task_id>" $HK stop "<workspace_id>" $HK tasks cancel "<task_id>" # also stops workspaces ``` **User**: 找一下登录相关的 todo ```bash $HK tasks list --status todo --query 登录 ``` **User**: 建个紧急任务修线上 500,修完降到中 ```bash $HK tasks create "修复线上 500" --priority urgent $HK tasks list --priority urgent $HK tasks update "<task_id>" --priority medium ``` ## curl snippets ```bash curl -s "$HELIOS_KANBAN_URL/api/health" | jq . curl -s "$HELIOS_KANBAN_URL/api/info" | jq '.data.config.executor_profile' curl -s "$HELIOS_KANBAN_URL/api/approvals" | jq '.data' curl -s "$HELIOS_KANBAN_URL/api/repos/$HELIOS_KANBAN_REPO_ID/branches" | jq '.data[].name' ```
INSTALL.md
# Agent Self-Install Guide — Helios Kanban Remote Skill
> **Audience**: AI agents (Cursor, Claude Code, Hermes, Codex, etc.)
>
> **Trigger**: User says "安装 helios-kanban-remote 技能", "install helios kanban skill", or gives you this repo / INSTALL.md URL.
>
> **Goal**: Clone this GitHub repo, install the skill, configure, and verify — **without human manual steps**. Execute every shell command yourself. Ask the user only when information is missing.
---
## Source (this repository)
| Item | Value |
|------|-------|
| **Repository** | https://github.com/SolomonFang/vibe-kanban |
| **Clone URL** | `https://github.com/SolomonFang/vibe-kanban.git` |
| **Skill path** | `skills/helios-kanban-remote/` |
| **Default branch** | `hly-dev` |
| **This document** | https://github.com/SolomonFang/vibe-kanban/blob/hly-dev/skills/helios-kanban-remote/INSTALL.md |
The skill is published **inside this repo**. Do not look for a separate package — clone or use this repository directly.
---
## Agent instructions — follow in order
```
Install progress:
- [ ] Step 1: Detect environment
- [ ] Step 2: Get skill files from this repo
- [ ] Step 3: Install to agent skills directory
- [ ] Step 4: Check dependencies (curl, jq)
- [ ] Step 5: Configure HELIOS_KANBAN_URL
- [ ] Step 6: Verify connectivity
- [ ] Step 7: Report result to user
```
---
### Step 1: Detect environment
```bash
uname -s
echo "HOME=$HOME"
pwd
```
Determine agent type and `SKILLS_ROOT`:
| Agent | `SKILLS_ROOT` |
|-------|---------------|
| Cursor (global) | `$HOME/.cursor/skills` |
| Claude Code | `$HOME/.claude/skills` |
| Cursor (project) | `<workspace>/.cursor/skills` |
| Hermes / other | user-provided, or `$HOME/.cursor/skills` |
```bash
SKILLS_ROOT="$HOME/.cursor/skills" # adjust per table
SKILL_DIR="$SKILLS_ROOT/helios-kanban-remote"
REPO_URL="https://github.com/SolomonFang/vibe-kanban.git"
BRANCH="hly-dev"
REPO_DIR="" # set in Step 2
```
**Do not** install into `~/.cursor/skills-cursor/` (reserved by Cursor).
---
### Step 2: Get skill files from this repo
**Option A — already inside this repository** (e.g. workspace is `vibe-kanban`):
```bash
REPO_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
test -f "$REPO_DIR/skills/helios-kanban-remote/SKILL.md" || {
echo "error: skill not found in current repo"; exit 1
}
echo "Using local repo: $REPO_DIR"
```
**Option B — not in repo, clone from GitHub** (default):
```bash
REPO_DIR="${TMPDIR:-/tmp}/vibe-kanban"
rm -rf "$REPO_DIR"
git clone --depth 1 -b "$BRANCH" "$REPO_URL" "$REPO_DIR"
test -f "$REPO_DIR/skills/helios-kanban-remote/SKILL.md" || {
echo "error: clone succeeded but skill path missing"; exit 1
}
echo "Cloned repo to: $REPO_DIR"
```
---
### Step 3: Install to agent skills directory
```bash
mkdir -p "$SKILLS_ROOT"
rm -rf "$SKILL_DIR"
cp -r "$REPO_DIR/skills/helios-kanban-remote" "$SKILL_DIR"
chmod +x "$SKILL_DIR/scripts/hk.sh"
HK="$SKILL_DIR/scripts/hk.sh"
# Verify
test -f "$SKILL_DIR/SKILL.md" && test -f "$HKAionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/solomonfang/skills/helios-kanban-skills",
"sourceUrl": "https://clawhub.ai/solomonfang/skills/helios-kanban-skills",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T12:11:38.926Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T12:11:38.926Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2.7K downloads",
"href": "https://clawhub.ai/solomonfang/helios-kanban-skills",
"sourceUrl": "https://clawhub.ai/solomonfang/helios-kanban-skills",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T12:11:38.926Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.0",
"href": "https://clawhub.ai/solomonfang/helios-kanban-skills",
"sourceUrl": "https://clawhub.ai/solomonfang/helios-kanban-skills",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-31T07:36:49.606Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.0",
"description": "Initial release of Helios Kanban Remote skill. - Adds remote control for Helios Kanban via REST API: list, create, update tasks; start/stop coding agents; follow up; approve or deny processes; and check status. - Provides command-line interface (`hk.sh`) examples for typical workflows and operations. - Defines environment variable configuration for remote operations and project/repo defaults. - Clarifies feature scope, including actions requiring desktop/web access and safety rules for task deletion and network exposure. - Includes quick-reference tables for commands, statuses, priorities, and agent/executor names.",
"href": "https://clawhub.ai/solomonfang/helios-kanban-skills",
"sourceUrl": "https://clawhub.ai/solomonfang/helios-kanban-skills",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-31T07:36:49.606Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
