kage-ai 0.1.5

AI-native cron task runner for per-project scheduled prompts and commands.

kage 影 - Autonomous AI Project Agent

English | 日本語

kage is an autonomous execution layer for project-specific AI agents. It schedules AI-driven tasks via cron, maintains state across runs using a persistent memory system, and provides advanced workflow controls.

Features

• Autonomous Agent Logic: Automatically decomposes tasks into GFM checklists and tracks progress.
• Persistent Memory: Stores task state in .kage/memory/ to maintain context.
• Advanced Workflow Controls:
  • Execution Modes: continuous, once, autostop.
  • Concurrency Policy: allow, forbid (skip if running), replace (kill old).
  • Time Windows: Restrict execution using allowed_hours: "9-17" or denied_hours: "12".
• Markdown-First: Define tasks using simple Markdown files with YAML front matter.
• Layered Configuration: .kage/config.local.toml > .kage/config.toml > ~/.kage/config.toml > defaults.

Installation

curl -sSL https://raw.githubusercontent.com/igtm/kage/main/install.sh | bash

Task Example (.kage/tasks/audit.md)

---
name: Project Auditor
cron: "0 * * * *"
mode: continuous
concurrency_policy: forbid
allowed_hours: "9-18"
denied_hours: "12"
timezone: "Asia/Tokyo"
provider: gemini
---

# Task: Continuous Health Check
Analyze the current codebase for architectural drifts.

Commands

• kage onboard: Global setup.
• kage init: Initialize kage in the current directory.
• kage run: Manually trigger tasks.
• kage task list: List all tasks.
• kage task show <name>: Show detailed configuration.
• kage doctor: Diagnose configuration health.

Configuration

• ~/.kage/config.toml: Global settings.
• .kage/config.toml: Project-shared settings.
• .kage/config.local.toml: Local overrides (git-ignored).
• .kage/system_prompt.md: Project-specific system prompt.