Operating Pattern
Fit check
| Question | Practical answer |
|---|---|
| What do you install? | humanlayer from HumanLayer/humanlayer |
| What is the first command? | npx humanlayer --help |
| What proves it works? | npx humanlayer --help |
| How long should a pilot take? | 10 minutes for a small repo or sandbox |
Adoption loop
- Run the tool on a disposable branch or sandbox project.
- Capture before/after output so reviewers can see the exact effect.
- Add the smallest CI or local check that prevents regressions.
- Document owner, upgrade command, and rollback command in the repo.
Recommended use
Use it as a control plane around agent work: define which actions need approval, who can approve them, and what context must be shown before a decision.
Guardrails
The current README flags new access as waitlist-based; treat adoption as an evaluation path, not a guaranteed self-serve rollout.
Rollout checklist
- Pin the package or release version before using it in CI.
- Keep credentials in environment variables or the platform secret store.
- Add one owner who is responsible for upgrades and breaking-change triage.
- Re-check the GitHub repo before writing docs that mention APIs or install paths.
FAQ
Q: Is this production-ready?
A: The repo exists at https://github.com/HumanLayer/humanlayer and has 10,753 GitHub stars. Treat the first rollout as a controlled pilot until your team has tested install, rollback, and CI behavior.
Q: Why use it instead of a generic script? A: The value is repeatability: a named package, a documented command, a source repo, and a small verification path that can be reviewed by teammates.
Q: What should I measure first? A: Measure setup time against the 10 minutes target, count how many files or tasks it changes, and record whether the CI command catches the same issue locally.