Manifest commands

These commands create, validate, and compile Cell manifests.

ikary init [project-name]

Creates a new Cell manifest project with an interactive wizard.

ikary init my-app

The wizard prompts for a project description and generates:

• manifest.json — starter Cell manifest
• CLAUDE.md — AI context for Claude Code
• .mcp.json — MCP server configuration
• .claude/commands/ — slash command templates

After scaffolding, the wizard prints next steps for your chosen workflow.

---

ikary validate <path>

Validates a Cell manifest against the schema and runs semantic checks.

ikary validate ./manifest.json

On success:

Validating manifest
manifests/examples/minimal-manifest.yaml

- Parsing and validating...
✔ Manifest is valid

  Entities: 0
  Pages:    1
  Roles:    0

On failure, each error is listed with its path and message:

Validating manifest
docs/fixtures/invalid.json

- Parsing and validating...
✖ Found 1 error(s)

✖ spec.pages[customers].entity Page references unknown entity key: "contact"

Pass --explain to fetch fix suggestions for each error from the IKARY guidance API:

ikary validate ./manifest.json --explain

Option	Description
--explain	Fetch fix suggestions for each validation error

---

ikary compile <path>

Compiles a Cell manifest to its normalized form. The engine resolves defaults, derives computed fields, and produces the structure that runtimes consume.

ikary compile ./manifest.json

Write the output to a file:

ikary compile ./manifest.json -o compiled.json

Print to stdout:

ikary compile ./manifest.json --stdout

Option	Description
-o, --output <file>	Write compiled JSON to a file
--stdout	Print compiled JSON to stdout

---

ikary preview <path>

Compiles a manifest and opens a standalone browser preview.

ikary preview ./manifest.json

This command does not require the local stack.