makecli

Manages Make platform apps, entities, relations, records, and deployments via the makecli CLI.

5|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/qfeius/make-platform-skills --skill makecli-qfeius
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: makecli
Source: https://github.com/qfeius/make-platform-skills/tree/main/skills/makecli
Command: npx skills add https://github.com/qfeius/make-platform-skills --skill makecli-qfeius

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing Make platform resources—apps, entities, relations, records, and code deployments—requires many CLI commands with specific flags, workflows, and safety checks. This Skill guides the AI to run makecli correctly: verifying login first, previewing schema changes with diff before apply, and deploying with proper commit and confirmation gates. ## Core Features & Use Cases - Declarative Schema Workflow: Write DSL YAML under apps/dsl/, preview changes with makecli diff, then apply with makecli apply for reproducible, safe schema management. - Code Deployment: Run makecli app deploy --wait to push committed HEAD and block until the build reaches a terminal state, with machine-readable exit codes (0 success, 2 failed, 124 timeout). - Resource & Data Operations: Create, list, update, and delete apps, entities, relations, and records, including CEL-filtered queries and server-side GROUP BY aggregation. - Use Case: Ask the assistant to create a new Make app, define its entities in DSL YAML, preview and apply the schema, then deploy to preview and report the live URL. ## Quick Start Ask the assistant to log in to Make, create an app called shop, apply the DSL schema under apps/dsl, and deploy it with makecli app deploy --wait.

Frequently Asked Questions about makecli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a Make app with makecli?

Commit all changes first, then run `makecli app deploy --wait` from the project directory. It pushes the committed HEAD and blocks until the build finishes, exiting 0 on success, 2 on failure, or 124 on timeout.

How do I create or update entities on the Make platform?

Write DSL YAML under apps/dsl/, preview changes with `makecli diff -f apps/dsl`, then run `makecli apply -f apps/dsl`. Entities and relations are upserted, while apps are create-only and never updated by apply.

How do I check makecli login and token status?

Run `makecli configure verify --output=json` to check whether the current profile has a valid token. If missing or expired, the user must run `makecli login` interactively via the `!` shell prefix for browser OAuth.

Can makecli filter and aggregate records?

Yes. `makecli record list` accepts a server-side CEL `--filter` expression, and `makecli record aggregate` performs server-side GROUP BY with `--group-json` dimensions and `--aggregates-json` metrics like count, sum, and avg.

Why does makecli app deploy fail with a dirty worktree error?

Deploy pushes only the committed HEAD and refuses to run when the worktree has uncommitted changes. Commit everything with git first, since deploy never auto-commits.

When should I use diff and apply instead of imperative commands?

Use YAML plus `makecli diff` and `makecli apply` for bulk schema setup because it is reproducible and previewable. Reserve imperative commands like entity create or record delete for one-off operations and data CRUD.