Ikiro Docs

Getting Started

Build your first superpower in 5 minutes.

Prerequisites

  • An Ikiro account (sign up at ikiro.ai)
  • A companion activated (Luna, Nyx, Echo, Kael, or Mochi)

That's it. No API keys, no local setup, no coding experience required.

Step 1: Open the Builder

Go to ikiro.ai/dashboard/builder and click New Superpower.

Click "Describe what you want" at the top.

Step 2: Describe your superpower

Type what you want in plain English. For example:

A joke teller that gets random programming jokes when I say "tell me a joke" or "make me laugh"

Click Generate Superpower. The AI will create a complete definition including triggers, operations, and response templates.

Step 3: Preview and refine

You'll see a preview showing:

  • The superpower's name and description
  • Actions with their operations
  • Trigger phrases that activate it

If something's not right, click Refine and describe what to change:

"Make it only tell dad jokes, not programming jokes"

Step 4: Open in Builder

Click Open in Builder to see your superpower as a visual flow in the node editor.

The node editor shows:

  • Purple nodes — Triggers (what activates the superpower)
  • Blue/yellow nodes — Operations (what it does)
  • Green nodes — Responses (what the persona says)

You can drag nodes, edit properties in the right panel, and add new operations from the palette on the left.

Step 5: Test

Click the Test button in the toolbar. Type a message that should trigger your superpower:

tell me a joke

The dry-run panel shows what would happen: which action matched, which operations ran, and what the response would be.

Step 6: Publish

Click Publish in the top-right. Choose Private (only you) or Public (marketplace).

Your superpower is now live. It's automatically equipped to Luna — text her the trigger phrase and see it work.

What's next?

On this page