Ikiro Docs

Quickstart — Web Builder

Build a superpower using the visual builder and natural language.

The web builder is the fastest way to create a superpower. Describe what you want, preview it, edit visually, and publish — all from your browser.

Create from description

  1. Go to ikiro.ai/dashboard/builder
  2. Click New SuperpowerDescribe what you want
  3. Type your idea:

"Check the weather and tell me if I need an umbrella. Use Fahrenheit."

  1. Click Generate Superpower (or press Cmd+Enter)

The AI generates a complete definition with triggers, operations, and responses.

The visual editor

After clicking Open in Builder, you'll see a node-based flow editor:

Node types

NodeColorWhat it is
TriggerPurpleKeywords and phrases that activate the action
OperationVariesAn individual step (API call, LLM, calculation, etc.)
ResponseGreenWhat the persona says back
ConditionalOrangeIf/then/else branching

Editing nodes

Click any node to edit its properties in the right panel. For example, clicking an http_request node lets you edit:

  • URL
  • Method (GET/POST)
  • Headers
  • Response path (which JSON field to extract)

Adding nodes

Drag operations from the palette on the left onto the canvas. Connect them by dragging from one node's handle to another.

Template variables

Response templates use double-brace syntax to reference data:

{{$vars.weather_data.temp}}F and {{$vars.weather_conditions.description}}

Available variables:

  • {{$input.text}} — the user's message
  • {{$state.field}} — session state
  • {{$vars.output_name}} — operation results (by output name)
  • {{$now.date}}, {{$today.start}} — time helpers

Testing

Click Test in the toolbar. Type a message and see:

  • Which action was matched
  • Each operation's result (success/failure)
  • The final response text
  • State before and after

Publishing

Click Publish → choose visibility:

  • Private — only you can use it
  • Public — submitted to the marketplace for review

After publishing, the superpower is automatically equipped to Luna. Text her the trigger phrase and it works immediately.

Iterating

To edit a published superpower:

  1. Go to My Superpowers in the developer portal
  2. Click the superpower
  3. Click Open in Builder
  4. Edit, test, and re-publish

Re-publishing updates the existing superpower in place — no duplicates.

On this page