Synara Configuration Guide

Understanding the synara.config.json file.

The synara.config.json file sits at the root of your project and controls the global behavior of the Synara Framework.

Schema Overview

Here is a comprehensive list of all supported configuration blocks:

{
  "preset": "none",
  "claudeCode": false,
  "autoApprove": false,
  "quotaFallback": {
    "enabled": true,
    "runtimes": []
  },
  "agents": [],
  "skills": [],
  "playbooks": [],
  "qualityGates": []
}

1. Core Settings

  • preset (string): The active template preset for the project.
    • "none": No predefined templates.
    • "full-stack": Loads full-stack web architectures.
    • "frontend": Loads frontend-focused templates.
    • "backend": Loads backend microservices templates.
    • "mobile-adv": Loads advanced React Native / Android templates.
    • "qa-automation": Loads QA and automation pipelines.
  • claudeCode(boolean): Flag to indicate if the project uses Anthropic's Claude Code CLI as the primary runtime.
  • autoApprove (boolean): Controls whether CLI subcommands prompt for human confirmation.
    • true: Bypasses confirmation gates (useful for CI/CD environments).
    • false: Interactive mode, requires manual approval.

    Note: Can also be set via the SYNARA_AUTO_APPROVE=true environment variable.

2. Quota & Rate Limit Control

  • quotaFallback (object): Manages the API failover behavior when an AI model hits a rate limit or quota depletion.
    • enabled (boolean):
      • true: Automatically switch to the next available runtime if an error occurs.
      • false: Disable failover. The agent will only use the primary tool and stop on quota errors.
    • runtimes (array of strings): Specify an exact, strict sequence of fallback runtimes to use.
      • "ANTIGRAVITY": Google Antigravity SDK (Native Python).
      • "AGY" (or "ANTIGRAVITY_CLI"): Google Antigravity interactive CLI.
      • "CLAUDE_CODE" (or "CLAUDE"): Anthropic Claude Code CLI.
      • "CODEX" (or "CODEX_CLI"): Codex interactive CLI.
      • "LOCAL_CLI": Local host shell execution environment.
      • "CI_RUNNER": CI/CD Pipeline isolated execution environment.

3. Registry Arrays

These arrays track which Synara modules have been downloaded or registered locally in the project. They are managed automatically by the synara-ai add-* commands.

  • agents (array of strings): List of registered agents (e.g., ["react-native-expert"]).
  • skills (array of strings): List of registered skills (e.g., ["git-manager"]).
  • playbooks (array of strings): List of registered playbooks.
  • qualityGates (array of strings): List of configured quality gates.
Previous: CLI Commands