Skip to main content

Install and verify Termyte

Install

Termyte requires Node.js 20 or later.
npm install -g termyte
Confirm the installed command:
termyte --help
Termyte does not require signup, initialization, or a cloud service.

Verify the dependable workflow

Run a non-executing check:
termyte check "cat .env"
You should see a block decision and Executed: false. Check that logs were created:
termyte logs
The command should appear in the repository-local check log.

Verify policy

termyte policy presets
termyte policy show
termyte policy test "npm publish"
policy show should include the built-in safe-default preset.

Verify your machine

termyte doctor
Doctor checks:
  • Node, npm, and Git availability;
  • workspace and local-state write access;
  • policy and SQLite state;
  • shell session and shim creation;
  • guard communication and shim smoke execution;
  • optional coding agents and shells;
  • packaged CLI assets.
Optional missing agents, shells, or WSL support can be warnings. A shell runtime failure means the stable check workflow can still work, but you should not trust experimental interception on that machine.

Update

npm install -g termyte@latest
termyte doctor
After updating, review both policy systems:
termyte policy show
termyte policies status
policies status reports whether the experimental runtime’s stored defaults are stale. It does not overwrite customized policy.