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

Verify a decision

Find the recorded decision for an agent action.

Run synkro status first. Confirm the service is healthy, enforcement is active, and your repository has a valid synkro.lock. Note the time so you can find this action in the event log.

synkro status reports service health. To check your project's Rules and actions, use the verification commands below.

If you approved connecting your agent through synkro onboard, use synkro onboard verify as described in the Quickstart. It checks the first Rule and action. For the full event history, use your signed-in CLI and follow the steps below. The connected agent can also follow these steps to inspect its own installation; its results exclude other users' and installations' activity.

Ask the agent to run a command

In a fresh agent session, send:

Run git status --short in this repository. Do not change any files.

Let the agent run it through its command tool so Synkro receives the action.

Find its decision

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

Find a new verdict.created event. Check its time, session and decision against the command you asked the agent to run. Hosted results include other users and machines in your organization, so the newest event may not be yours.

If the verdict does not include the command itself, copy its correlation_id and use it to read the related action:

synkro events --correlation REPLACE_WITH_CORRELATION_UUID --details

Replace the placeholder with the ID from the output.

Read the decision's reason, check status and matching Rules. If it reports paused enforcement or an error, follow Troubleshooting. Use the tutorial Rule to test a specific match and block.

If the result is missing

Run synkro events --limit 10 --json to see recent activity, then follow No new decision appears.