Upgrade chisel and refresh skills

You upgraded chisel and want your installed agent skills to match the new version’s rules. This guide upgrades the CLI package and refreshes the installed skills in one go.

Upgrade the CLI

Python

chisel update self
chisel update self --manager uv          # auto | pip | pipx | uv
chisel update self --dry-run

TypeScript

chisel-js update self
chisel-js update self --manager bun      # auto | npm | bun
chisel-js update self --dry-run

update self detects how the package was installed and re-installs the latest version. Use --manager to force a specific package manager, and --dry-run to preview.

Refresh the installed skills

Skills shipped with the new version may have changed; fix guidance wording, new rules, restructured references. update skills overwrites the installed skills with the bundled copies so they always match the checker version you’re on.

Python

chisel update skills --target codex
chisel update skills --target claude -y            # no confirmation (automation)
chisel update skills --target codex --dry-run --json

TypeScript

chisel-js update skills --target codex
chisel-js update skills --target claude -y
chisel-js update skills --target codex --dry-run --json

update skills always overwrites local modifications, so chisel asks for confirmation before writing.

First install vs refresh

If skills aren’t installed yet in the target directory, the Python CLI uses chisel setup for the first install and chisel update skills for refreshes. The TypeScript CLI uses chisel-js update skills for both; there is no separate setup command.

Verify

After upgrading, run a check to confirm the new ruleset behaves as expected on your code:

Python

chisel --version
chisel check ./your-backend --strict

TypeScript

chisel-js --version
chisel-js check ./your-frontend

What’s next

• Give your AI agent the rules: the first-install flow (if you skipped it).
• Commands reference: every flag for update self and update skills, side by side.