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
--forceis used.
sync
Sync configured templates in synara.config.json into local folders.
list
List available registry components and active installation statuses.