What is Code Polishy?

Code Polishy is an agent-first repository policy tool. It gives coding agents, developers, and CI one versioned policy for deterministic checks across changes, dependencies, tests, and merges.

How does Code Polishy work?

Ask a coding agent to set it up once. The repository locks the exact release, stores the project policy in .code-polishy.json, and carries the recurring workflow in AGENTS.md.

What does Code Polishy check?

It checks architecture boundaries, code quality, dependency policy, vulnerabilities, test selection, and the project-specific checks declared by the repository.

When should I run Code Polishy?

Run code-polishy test --changed while editing, dependency-review when dependencies change, and merge-gate once before merging the final candidate.

Is Code Polishy free and open source?

Yes. Code Polishy is open-source software released under the Apache License 2.0.

Code Polishy — deterministic guardrails for agentic development

Deterministic guardrails for agentic development.

current release v0.18.0

Set up with AI View on GitHub

Deterministic checks. One versioned policy.

Ask your coding agent to set up Code Polishy once. The repository then locks the exact release and carries the recurring workflow in AGENTS.md.

Your agent runs it. Policy chooses the checks.

code-polishy test --changedfast feedback while editing
code-polishy dependency-review --base origin/mainreview a dependency update
code-polishy merge-gate --base origin/mainone final pre-merge gate

Read the docs

Version 0.18.0

Agent-first by design.

Checked-in rules.
One policy for local work and CI.

During the change: Changed files select focused suites for affected modules.
Before the merge: One gate selects the recommended or full validation profile.
Optional isolation: Task sessions run unattended work in a disposable, module-bounded worktree.

The short version

Questions, answered.

The practical facts for developers, coding agents, and teams evaluating Code Polishy.

What is Code Polishy?: Code Polishy is an agent-first repository policy tool. It gives coding agents, developers, and CI one versioned policy for deterministic checks across changes, dependencies, tests, and merges.
How does Code Polishy work?: Ask a coding agent to set it up once. The repository locks the exact release, stores the project policy in .code-polishy.json, and carries the recurring workflow in AGENTS.md.
What does Code Polishy check?: It checks architecture boundaries, code quality, dependency policy, vulnerabilities, test selection, and the project-specific checks declared by the repository.
When should I run Code Polishy?: Run code-polishy test --changed while editing, dependency-review when dependencies change, and merge-gate once before merging the final candidate.
Is Code Polishy free and open source?: Yes. Code Polishy is open-source software released under the Apache License 2.0.