kirocrew-app-dev

Kiro Crew App Development

Guide for building external Kiro Crew apps against the current App Kit manifest, lifecycle, UI SDK, and registry contracts. The canonical field and API references live in App Kit.

When to Use

• User says "create a kirocrew app", "build an app", "make an app for kirocrew"
• User says "package this as an app", "publish this to the app store"
• User is building UI pages, crons, or skills that should be distributable

App Structure

my-app/
├── app.json              # Manifest (required)
├── ui/
│   ├── index.mjs         # ESM React component (default export)
│   └── icon.svg          # Sidebar icon (SVG or PNG)
├── skills/
│   └── my-skill/
│       └── SKILL.md      # Skill spec
├── scripts/
│   ├── install.sh        # Optional registry-install setup hook
│   └── uninstall.sh      # Cleanup script
└── README.md             # Optional docs

app.json Manifest

{
  "name": "my-app",
  "displayName": "My App",
  "version": "1.0.0",
  "description": "What it does in one sentence.",
  "author": "login",
  "tags": ["relevant", "tags"],
  "skills": [
    "skills/my-skill"
  ],
  "crons": [
    {
      "name": "my-cron",
      "message": "Run the scheduled app workflow.",
      "every": 900,
      "silent": true,
      "persistent_session": false
    },
    {
      "name": "market-open",
      "message": "Summarise the overnight tape.",
      "cron_expr": "30 9 * * 1-5",
      "timezone": "America/New_York",
      "skip_dates": ["2026-12-25"]
    }
  ],
  "permissions": {
    "api": ["/api/apps/my-app/config", "/api/chat", "/api/chat/*"],
    "mcpTools": ["local_knowledge_search", "send_message"],
    "network": true,
    "cron": true
  },
  "ui": {
    "entry": "index.mjs",
    "pages": [
      {
        "route": "/apps/my-app",
        "label": "My App",
        "iconUrl": "icon.svg"
      }
    ]
  },
  "setup": {
    "onInstall": "bash scripts/install.sh",
    "onUninstall": "bash scripts/uninstall.sh"
  }
}