CLI Command System

The Typer-based CLI command synara-ai manages Synara environments, synchronizes templates, and performs diagnostics.

init

Initialize Synara configuration, directories, and templates.

  • --preset: Name of the preset stack (react-native-expo, nextjs, nestjs, fullstack).
  • --detect: Automatically detect the workspace's project stack.
  • --dry-run: Performs a dry-run showing what files/directories would be created without writing them to disk.

doctor

Run diagnostic health checks on the project setup.

  • Validates the existence of the .synara/ folder and all mandatory sub-directories.
  • Parses and checks validity of synara.config.json.
  • Audits configured templates, verifying SHA-256 hashes against manifest entries.

add-agent [name]

Add a packaged agent template from the registry into your project.

  • --force: Force overwrite of existing files, backing up local changes under .synara/.backups/.

add-skill [name]

Add a packaged skill template from the registry into your project.

update

Safely update all installed templates to latest versions.

  • Iterates through configured agents, skills, playbooks, and quality gates.
  • If a file was locally modified, it skips it to protect custom changes unless --force is used.

sync

Sync configured templates in synara.config.json into local folders.

list

List available registry components and active installation statuses.