Glixo Builder Docs docs.glixo.dev

App Maker (App Creator)

App Maker is the Agxos App Creator workflow: you describe a small desktop app, the agent scaffolds a real module under your workspace, you iterate until it looks right, then optionally generate marketplace assets and publish.

When to use App Maker

Both paths produce a module directory (typically under .agxos/extensions/<slug>/) with glixo.module.json and app source.

How to start

  1. Open Glixo Code and switch to Agxos mode.
  2. Launch App Creator from the desktop or Start menu.
  3. Enter your request (e.g. “image viewer for PNG and JPEG with zoom”) and a feature list.
  4. Preview the app on the Agxos desktop — send feedback until you approve the iteration.

Workflow phases

The creator runs a checkpointable workflow:

  1. Spec — capture an AgxosAppSpec at .agxos/spec.json (id, name, app template, capabilities).
  2. Scaffold — generate files and glixo.module.json from the spec.
  3. Iterate — agent edits; you approve or request changes (gate loop).
  4. Describe (optional) — marketplace description text.
  5. Icon (optional) — generate assets/icon.svg.
  6. Demo (optional) — record an Agxos replay for glixo.io embeds.
  7. Publish (optional, gated) — push to the catalog via glixo.dev.

Progress is saved in .agxos/workflow/checkpoint.json so you can resume after closing the session.

AgxosAppSpec (simplified)

{
  "id": "glixo.my-notes",
  "name": "My Notes",
  "description": "Quick scratch pad",
  "version": "0.1.0",
  "app": {
    "id": "my.notes",
    "name": "My Notes",
    "template": "note",
    "width": 560,
    "height": 420,
    "actions": [{ "id": "write", "description": "Set note text" }]
  },
  "capabilities": ["filesystem.workspace.read"]
}

The host converts the spec to a full manifest via specToManifest. Template apps publish end-to-end today; custom coded apps need a built bundle artifact.

Publishing from App Maker

  1. Finish the iterate gate (approved = true).
  2. Run optional describe / icon / demo steps.
  3. Confirm publish — requires sign-in on glixo.dev and a public source repository URL for marketplace-listed Agxos apps.

Or publish manually: validate on the dashboard, then use the authenticated catalog API (see Publish flow).

Tips