What is Synkro?A package manager for agents, with Rules for using your software.Getting startedQuickstartLet your agent set up Synkro, create your first Rule, and verify an action.Getting startedSetup checklistCheck your account, installation, repository, and first agent decision.SetupInstall and verifyInstall the CLI, sign in, and connect your agent.SetupSet up your agentConnect your agent and verify its first tool call.SetupVerify a decisionFind the recorded decision for an agent action.SetupYour first decisionRead your first agent decision and test a Rule.SetupHow Synkro worksUnderstand how Synkro applies Rules and records agent decisions.Core conceptsRules and ControlsChoose repository Rules for actions and Controls for access restrictions.Core conceptsRule outcomesUnderstand when an action continues, needs approval, or must be changed.Core conceptsRulesAdd, test, update, and remove the Rules used by your repository.GuidesEventsFind recorded agent actions and decisions with the Synkro CLI.GuidesApprove MCP toolsChoose project approvals and package defaults for MCP tools.GuidesConsentReview and approve an agent action before it runs.GuidesFeedbackReport a Synkro bug or suggest an improvement with diagnostic context.GuidesBilling and usageAdd funds and check your organization's balance and usage.GuidesGitHubConnect GitHub to discover Rules from private repositories.IntegrationsCLI commandsFind the current commands for setup, Rules, events, account, and recovery.ReferenceSupported agentsFind the installed Synkro files and the checks that apply to each agent.ReferenceTroubleshootingFix setup, sign-in, missing decisions, Rule, and approval problems.Reference
Documentation
Onboarding

Your first decision

Read your first agent decision and test a Rule.

First verify a new decision for git status --short. Then read its outcome.

Read the result

Your project's Rules decide the outcome:

  • allow or flag: the command can run.
  • ask: Synkro needs your approval before the same action is retried.
  • block: the action is refused. A matching fix Rule also refuses it, with instructions to correct it.

Read the matching Rule and reason with:

synkro events --type verdict --limit 5 --details

See Rule outcomes for how Synkro combines matching Rules.

Synkro messages start with [⧉ synkro] so you can distinguish them from the agent's own reply.

Test a block

Add the tutorial Rule, then ask your agent to run printf synkro-rule-demo. Synkro blocks that exact command and records the matching Rule.

No new decision? Return to agent setup or Troubleshooting.