Skip to main content

Configure a repository

Ask your agent to connect the repository's existing tools to Shaka:

$shaka Configure this repository for Shaka. Reuse its existing setup,
test, and validation commands. Explain the review and merge choices.
Use merge policy ask.

The agent inspects your project, asks for missing choices, and prepares a setup PR:

FilePurpose
.agents/agent-workflow.ymlReview, merge, branch, and WIP settings
.agents/bin/setupInstall project dependencies
.agents/bin/testRun tests; accept focused test arguments
.agents/bin/validateRun the complete pre-PR checks
.agents/bin/validate-local (optional)Run a faster local check before review
.agents/bin/trigger-hosted-ci (optional)Start deferred CI after local fixes; requires validate-local
.agents/trusted-github-actors.ymlWhose public GitHub comments the agent may read
AGENTS.mdProject instructions and constraints

These scripts usually wrap commands the project already has. In Shaka's own repository, .agents/bin/setup installs development dependencies; bin/install installs Shaka into your coding agent. They serve different users.

To change a choice later:

$shaka Configure this repository to wait for all configured CI reviewers.
Keep merge policy ask.

See settings for values and defaults. Shaka's own configuration and scripts provide working examples.