Skip to content

CLI

All commands are run with npx mira-animator <command> (the binary is also available as mira once installed).

npx mira-animator --help        # list commands
npx mira-animator --version      # print version

Commands

Command Description
install Installs Mira in the current folder (agents, templates, config).
link <path> Links a folder or file as a content source.
sources Lists the linked sources.
status Shows the state of the installation and the decks.
update Updates agents and templates to the latest version.
uninstall Removes Mira from the current folder.

install

npx mira-animator install

Copies the agents to .claude/skills/, the templates to mira-templates/, creates decks/, and writes mira.config.json + CLAUDE.md. See Installation.

npx mira-animator link <path> [--name=<alias>] [--type=projeto|pdf|latex|texto]

Links a folder or file as a read-only content source.

Option Meaning
--name=<alias> Short alias used later to refer to the source.
--type=... projeto, pdf, latex or texto. Inferred when omitted.

See Linked sources.

sources

npx mira-animator sources

Lists every linked source with its alias, type and path.

Creating a deck (/mira-new)

Creating a deck is not a CLI command — you do it conversationally in Claude, by talking to the /mira-new skill:

/mira-new create a new presentation called 'my-talk'

It assembles decks/<name>/ from a template and registers it. You can spell out the template and theme in the same sentence:

/mira-new create a presentation called 'my-talk' with the aula-capitulo template and the mira-dark theme
Choice Values
Template aula-capitulo, pitch-projeto, demo-tecnica
Theme mira-dark, light-minimal, corporate-blue, neon-emerald

status

npx mira-animator status

Shows the installation state and the decks that exist.

update

npx mira-animator update

Updates the agents and templates to the latest version.

uninstall

npx mira-animator uninstall

Removes Mira from the current folder.