Reference · CLI
ara
The command-line tool and daemon: the single entry point for humans and agents. Add --json to any command for machine-readable output.
- ara doctorCheck installed editor prerequisites without a project
- ara profileLocal performance regression checks (no daemon or project required)
- ara initCreate a project: ara.project.json, AGENTS.md, .gitattributes, .gitignore, .mcp.json and a starter scene
- ara fmtRewrite documents in canonical form, repairing references
- ara checkValidate documents against the schema, references and prefabs
- ara schemaShow the Schema DB: types, document kinds and commands; with names, each one's fields, units and defaults (ara schema Light entity.create)
- ara mergeThree-way merge of a document; writes the result over ours (git: %O %A %B)
- ara resolveSettle the conflicts ara merge left in a document: ara resolve levels/a.scene --pick e_b2:name=theirs (or --ours / --theirs for all)
- ara docsGenerate docs for this engine version: llms.txt, llms-full.txt, per-type pages
- ara serveRun the project daemon (Engine Protocol on WebSocket, MCP at /mcp)
- ara mcpServe global MCP through Ara Hub; --root retains per-project mode
- ara hubManage the user-level Ara Hub and global MCP installation
- ara doRun one command as a transaction: ara do property.set -p entity=name:Crate -p path=Light.intensity -p value=500 --why "Dimmer crate light"
- ara queryFind entities: ara query "Light name:Lamp*"
- ara inspectShow a document's hierarchy, or entities in full
- ara historyList transactions, newest first
- ara undoUndo --author's latest transaction, or the given one
- ara redoRedo --author's most recently undone transaction
- ara reviewList agent changes awaiting review
- ara acceptAccept agent changes: a transaction, an entity's changes, or --all
- ara revertRevert agent changes: a transaction or an entity's changes
- ara logsShow diagnostics from every subsystem, grouped by code (--all: one by one)
- ara whyExplain a problem: ara why name:Crate not visible, ara why ARA1302, ara why "is the frame slow". Ranked causes with evidence and runnable fixes