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
Core concepts

Rule outcomes

Understand when an action continues, needs approval, or must be changed.

Each Rule has a mode that determines what happens when it matches.

ModeWhat happens
allowThe action can continue unless another check refuses it.
flagThe action continues and the match is recorded.
askThe action is refused until you approve that exact attempt.
fixThe action is refused with instructions for a corrected attempt.
blockThe action is refused. Consent cannot override it.

A fix does not edit code. The agent must change its action and try again.

When several Rules match

A refusal takes precedence over allow or flag. Approval cannot override a matching fix or block.

The recorded decision lists the matching Rules and explains the outcome.

Approval is handled by Synkro

For ask, Synkro refuses the action and shows how to approve it. Your agent's own permission settings do not count as Synkro approval.

You approve the pending request using the steps in Consent, then the agent retries the same action once.

Check the result

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

Match the decision to your agent's action using its time and session. See Verify a decision.