ikiro-dev-kit 2.0.0

Build AI agent tools with YAML — no code required. Dev kit for the Ikiro superpower platform.

Ikiro Dev Kit

Build AI agent tools with YAML. No code required.

Define what your tool does in a YAML file, deploy it, and a real AI agent decides when and how to use it — alongside 50+ built-in tools like calendar, email, web search, and memory.

Install

pip install ikiro-dev-kit

Quick Start

1. Get your API key

Sign up at ikiro.ai, go to Dashboard > Developer > Keys, and create a key.

2. Set environment variables

export IKIRO_API_KEY="ik_dev_YOUR_KEY"
export IKIRO_BACKEND_URL="https://api-dev.ikiro.ai"

3. Use with Claude Code (MCP)

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "superpower-dev": {
      "command": "ikiro-dev-kit",
      "args": ["mcp"],
      "env": {
        "IKIRO_API_KEY": "ik_dev_YOUR_KEY",
        "IKIRO_BACKEND_URL": "https://api-dev.ikiro.ai"
      }
    }
  }
}

Then tell Claude: "Scaffold a superpower called mood-tracker that remembers how I'm feeling"

4. Or use the CLI directly

# Create a new superpower
ikiro-dev-kit scaffold --name mood-tracker --description "Track daily mood"

# Validate your definition
ikiro-dev-kit validate --name mood-tracker

# Simulate locally (free, instant)
ikiro-dev-kit dry-run --name mood-tracker --message "I'm feeling great today"

# Deploy to your agent
ikiro-dev-kit deploy --name mood-tracker

# See available operations
ikiro-dev-kit list-operations

How It Works

A superpower is a YAML file that defines a tool an AI agent can use:

version: '1.0'
metadata:
  name: Mood Tracker
  description: Track and recall the user's mood over time
  category: health
  icon: heart

trigger_patterns:
  keywords: [mood, feeling, how am I]

actions:
  - id: log_mood
    triggers:
      keywords: [mood, feeling, happy, sad, stressed]
    operations:
      - type: llm_extract
        output: mood
        prompt: "Extract mood from: {{$input.text}}"
      - type: memory_write
        text: "User mood: {{$op.mood.mood}} ({{$op.mood.intensity}}/10)"
    response:
      template: "Logged: {{$op.mood.mood}}"

The agent sees your tool alongside 50+ built-in tools and autonomously decides when to use it based on the conversation.

Available Operations

Operation	What it does
llm_extract	Extract structured data from text
llm_generate	Generate text from a prompt
web_search	Search the internet
http_request	Call any REST API
memory_read	Recall what the agent knows
memory_write	Store knowledge permanently
notify	Proactively message the user
calendar_query	Query Google Calendar
gmail_search	Search Gmail
conditional	If/else branching
calculate	Safe math expressions
conversation_flow	Multi-turn dialogue

Run ikiro-dev-kit list-operations for the full list with details.

Links

• Documentation
• Superpower Spec
• Examples