anikamin940

anikamin940 / hitl-agent-ts

Public

HITL agent workflows in TypeScript: pause for human approval, multi-approver gates, timeouts, audit-friendly stores, Slack/webhook notify.

agentic-ai ai-agents approval-workflow governance hitl
20
0
100% credibility
Found Apr 19, 2026 at 20 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A TypeScript library for creating workflows that pause at approval gates for human decisions, featuring persistent storage options, notifications, a simple web service for approvals, a command-line tool, and testing helpers.

How It Works

1
🔍 Discover the tool

You find a helpful kit for building safe step-by-step tasks that pause for your personal review before doing anything important.

2
📥 Set it up

You bring the kit to your computer and get everything ready to create your first process in just a few moments.

3
📝 Build your process

You outline the simple steps of a task, like gathering info on a user account before deciding to remove it.

4
⏸️ It waits for you

You start the task and it smoothly pauses at the key decision point, sending you a clear notice to check it out.

5
Review and decide
👍
Approve it

You give the okay, maybe with a quick note, so it can move forward safely.

👎
Reject it

You say no and explain why, stopping things before they go too far.

6
▶️ Watch it finish

The task continues automatically based on your choice and wraps up with the final outcome.

🎉 All done safely

Your process completes perfectly, with that extra human touch ensuring nothing risky happened.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 20 to 20 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is hitl-agent-ts?

hitl-agent-ts lets you build HITL agentic AI workflows in TypeScript that chain async steps and pause for human approval before critical actions. It handles multi-approver gates, timeouts with reject/escalate/retry options, and audit-friendly stores like in-memory, SQLite, or Postgres for persistence across restarts. You get Slack/webhook notifications, a REST API for pending approvals and decisions, plus a CLI for quick testing—perfect for workflows needing human gates without custom plumbing.

Why is it gaining traction?

In a sea of agent frameworks, it stands out with dead-simple syntax for approval pauses and multi-approver counts, plus built-in timeouts and notify hooks that just work via Slack or webhooks. Developers dig the typed context passing between steps, resume-after-restart capability, and Vitest integration for reliable tests—no more flaky mocks for human input. The audit-friendly stores make compliance a breeze without extra tools.

Who should use this?

Backend engineers scripting agent workflows for ops like user deletions or resource provisioning, where human approval gates prevent disasters. Teams building HITL agentic AI in Node.js apps that need multi-approver flows, Slack alerts, and Postgres persistence for production audits. Avoid if you're in Python land or need complex branching beyond linear steps with gates.

Verdict

Grab it for prototypes or small-scale HITL workflows—20 stars and 1.0% credibility score signal early days, but thorough docs, Docker setup, and full test suite show polish beyond most pet projects. Scale cautiously until adoption grows.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.