kickd (Anbturki)

踢腿

后台自动化守护进程，具有任务调度、可组合技能、工作流引擎、凭证库、事件系统、webhook触发器、通知、插件生态系统和通过MCP的双向克劳德代码集成。

特性

• 任务调度器 --间隔时间(1h, 30m)，每天定时(at:09:00)，或完整的cron(0 9 * * MON-FRI)
• 技能引擎 --具有Zod验证输入/输出的可组合、可链接的工作单元
• 工作流引擎 --具有条件、并行执行和延迟的多步骤流水线
• 凭证保险库 --具有14种以上内置类型（GitHub、Slack、AWS、Stripe等）的加密凭据存储
• 事件系统 --反应式规则：“当任务X完成时，运行技能Y”
• Webhook触发器 --通过带有HMAC签名的HTTP webhooks触发任务/技能
• 通知 --任务成功/失败时的Slack、Discord或通用webhook警报
• 变量 --具有作用域和模板解析的持久键值存储
• 任务队列 --具有可配置限制的基于优先级的并发执行
• 使用回退重试 --具有指数退避和抖动的可配置重试
• 结构化日志记录 --使用JSON模式和文件输出对日志进行分级
• 普罗米修斯指标 — /metrics 监控端点
• 健康检查 --详细的运行状况报告（数据库、内存、队列、任务）
• 速率限制 --内存滑动窗口速率限制器
• 优雅关闭 --信号情报/信号处理干净
• SQLite持久性 --记录并可查询的所有运行、事件、变量和配置
• MCP服务器 --将所有内容公开为Claude Code可以直接调用的工具
• 克劳德代码桥 --从自动化中调用Claude Code CLI
• 插件系统 --从npm安装技能(`kickd install

`)

• HTTP API -所有操作的完整REST API
• 命令行界面 --从终端管理所有内容
• 认证 --可选的承载令牌身份验证
• 码头工人 --即用型Dockerfile

需求

• 包子 >= 1.0.0
• Claude 代码命令行界面 （可选，适用于克劳德桥）

快速开始

git clone https://github.com/anbturki/kickd.git
cd kickd
bun install
bun run start

验证： curl http://localhost:7400/health

CLI参考

# Tasks
kickd list                              # List all tasks
kickd run  [json]                   # Run a task
kickd history                       # Task run history

# Skills
kickd skills                            # List all skills
kickd skill  [json]                 # Run a skill

# Workflows
kickd workflow list                     # List workflows
kickd workflow run  [json]          # Run a workflow
kickd workflow delete               # Delete a workflow

# Variables
kickd vars list [scope]                 # List variables
kickd vars set              # Set a variable
kickd vars get                     # Get a variable
kickd vars delete                  # Delete a variable

# Credentials
kickd creds list                        # List stored credentials
kickd creds types                       # List available types (github, slack, aws, ...)
kickd creds add       # Store a credential (encrypted)
kickd creds get                   # View credential (sensitive values redacted)
kickd creds test                  # Test connectivity
kickd creds delete               # Delete a credential

# Webhooks
kickd webhook list                      # List webhooks
kickd webhook create  task:   # Create a webhook
kickd webhook delete                # Delete a webhook

# Events
kickd events                            # Show recent events
kickd events rules                      # List reactive rules
kickd events add  run_task:  # Add a rule

# Notifications
kickd notify add slack             # Add Slack notifications
kickd notify add discord           # Add Discord notifications

# Queue
kickd queue                             # Show queue stats

# Plugins
kickd install 
                 # Install a plugin from npm
kickd uninstall 
               # Uninstall a plugin
kickd plugins                           # List installed plugins

# Other
kickd stats                             # Global statistics
kickd health                            # Detailed health report
kickd ask "prompt"                      # Ask Claude Code

HTTP API

MCP服务器（克劳德代码）

添加 ~/.claude.json 或项目 .mcp.json:

{
  "mcpServers": {
    "kickd": {
      "command": "bun",
      "args": ["run", "mcp"],
      "cwd": "/path/to/kickd"
    }
  }
}

可用的MCP工具： list_automations, run_automation, run_skill, chain_skills, list_workflows, run_workflow, set_variable, get_variable, list_variables, queue_stats, list_credentials, store_credential, test_credential, list_credential_types, list_webhooks, create_webhook, list_event_rules, create_event_rule, get_task_history, get_stats, run_command, ask_claude.

添加任务

// tasks/my-task.ts
import type { Task, TaskResult } from "../src/types";

export const task: Task = {
  id: "my-task",
  name: "My Task",
  description: "Does something useful",
  handler: "tasks/my-task.ts",
  schedule: "0 9 * * MON-FRI", // weekdays at 9am (full cron)
  retry: { maxAttempts: 3, baseDelayMs: 1000, maxDelayMs: 30000, backoffMultiplier: 2 },
  enabled: true,
  status: "idle",
};

export async function handler(params?: Record): Promise {
  return { success: true, output: "Done", duration: 0 };
}

计划格式

添加技能

// skills/my-skill.ts
import { z } from "zod";
import { skills } from "../src/skills/engine";

skills.register({
  id: "my-skill",
  name: "My Skill",
  description: "A composable unit of work",
  input: z.object({ message: z.string() }),
  output: z.object({ result: z.string() }),
  execute: async (input) => {
    return { result: `Processed: ${input.message}` };
  },
});

工作流

定义结合任务、技能、条件、延迟和并行执行的多步骤流程：

curl -X POST http://localhost:7400/workflows \
  -H "Content-Type: application/json" \
  -d '{
    "id": "deploy-pipeline",
    "name": "Deploy Pipeline",
    "description": "Build, test, and deploy",
    "startStep": "build",
    "steps": [
      { "id": "build", "type": "task", "targetId": "build-app", "next": "test" },
      { "id": "test", "type": "task", "targetId": "run-tests", "next": "check" },
      { "id": "check", "type": "condition", "condition": "{{prev.success}} === true", "onTrue": "deploy", "onFalse": "notify-fail" },
      { "id": "deploy", "type": "skill", "targetId": "deploy-prod" },
      { "id": "notify-fail", "type": "skill", "targetId": "send-alert", "input": { "message": "Tests failed" } }
    ]
  }'

步骤类型： task, skill, condition, delay, parallel.

凭证保险库

使用静态AES-256-CBC加密安全地存储凭据。

# Generate an encryption key
openssl rand -base64 32
# Add to .env: KICKD_ENCRYPTION_KEY=

# Store a GitHub token
kickd creds add my-github github '{"token":"ghp_abc123..."}'

# Store Slack credentials
kickd creds add my-slack slack '{"botToken":"xoxb-...", "webhookUrl":"https://hooks.slack.com/..."}'

# Test connectivity
kickd creds test my-github

内置凭据类型： bearer, api_key, basic_auth, oauth2, github, slack, discord, stripe, openai, anthropic, linkedin, sendgrid, aws, custom.

事件系统

制定反应性规则——当有事情发生时，做其他事情：

# When task "hello" completes, run the "disk-usage" task
kickd events add task.completed run_task:disk-usage --source hello

# When any skill fails, run a notification task
kickd events add skill.failed run_task:alert

事件类型： task.completed, task.failed, task.retry, skill.completed, skill.failed, webhook.triggered, workflow.started, workflow.completed, workflow.failed.

Webhook触发器

通过HTTP从外部触发任务：

# Create a webhook for the "hello" task
kickd webhook create deploy-hook task:hello

# Trigger it (e.g., from GitHub Actions, Stripe, etc.)
curl -X POST http://localhost:7400/hooks/ \
  -H "Content-Type: application/json" \
  -d '{}'

通知

任务失败时收到警报：

# Via CLI
kickd notify add slack https://hooks.slack.com/services/...
kickd notify add discord https://discord.com/api/webhooks/...

# Or via environment variables
KICKD_NOTIFY_SLACK_URL=https://hooks.slack.com/services/...
KICKD_NOTIFY_DISCORD_URL=https://discord.com/api/webhooks/...

插件

从npm安装技能：

kickd install kickd-skill-example
kickd plugins

插件包可以导出 register(skills) 功能或a skills 阵列。

配置

cp .env.example .env

码头工人

docker build -t kickd .
docker run -p 7400:7400 -v kickd-data:/app/data kickd

在后台运行

macOS（launchd）

# Create plist at ~/Library/LaunchAgents/com.kickd.daemon.plist
# then:
launchctl load ~/Library/LaunchAgents/com.kickd.daemon.plist

pm2

pm2 start "bun run start" --name kickd
pm2 save

建筑

┌──────────────┐    MCP (stdio)    ┌───────────────────────────────────────┐
│  Claude Code │ ────────────────► │            kickd daemon               │
│              │ ◄──────────────── │                                       │
└──────────────┘                   │  ┌───────┐ ┌───────┐ ┌────────────┐  │
                                   │  │ Tasks │ │Skills │ │ Workflows  │  │
┌──────────────┐    HTTP :7400     │  └───┬───┘ └───┬───┘ └──────┬─────┘  │
│   You (CLI)  │ ────────────────► │      │         │            │        │
│              │ ◄──────────────── │  ┌───┴─────────┴────────────┴───┐    │
└──────────────┘                   │  │         Event Bus             │    │
                                   │  └───┬─────────┬───────────┬────┘    │
┌──────────────┐    Webhooks       │  ┌───┴───┐ ┌───┴────┐ ┌───┴──────┐  │
│   External   │ ────────────────► │  │Notify │ │SQLite  │ │Cred Vault│  │
│   Services   │                   │  └───────┘ └────────┘ └──────────┘  │
└──────────────┘                   └───────────────────────────────────────┘

许可证

麻省理工学院