gitwtfhub

wtf is lhic?

chengmatt416/lhic — explained in plain English

Analysis updated 2026-05-18

3TypeScriptAudience · developerComplexity · 4/5Setup · hard

TL;DR

A local-first automation runtime that turns browser and desktop tasks into verified, approval-gated actions, using fast rule-based execution for common tasks and an optional GPT-5.6 helper for ambiguous ones.

Mindmap

mindmap
  root((LHIC))
    What it does
      Local browser automation
      Desktop control
      Approval gated actions
    Tech stack
      TypeScript
      Playwright
      Node.js
      Electron
    Use cases
      Automate browser tasks
      Automate desktop actions
      AI assisted planning
    Audience
      Developers
      Automation builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Automate repetitive browser tasks like logging in, filling forms, or searching without calling an AI model for each step.

REASON 2

Automate native desktop actions such as launching apps or typing, with human approval required for sensitive steps.

REASON 3

Handle ambiguous browser tasks by optionally asking GPT-5.6 to propose the next step, which is then validated and verified locally.

What's in the stack?

TypeScriptPlaywrightNode.jsSQLiteElectron

How it stacks up

chengmatt416/lhic000madz000/payload-test-api-route-handlerakash-sr/memobsidian
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires Node.js 24, a local Playwright Chromium install, and running from source since the published npm package is outdated.

No license is stated in the visible README content.

Wtf does this do

LHIC, short for Local Human Intent Controller, is a runtime for automating browser and desktop tasks that runs locally on your machine rather than relying on a cloud service to decide what to do. Its goal is to take a task a person wants done and turn it into precise, checkable computer actions, such as clicking, typing, or navigating a web page. Most common tasks, like logging into a site, filling out a form, or searching, run through what the project calls the Fast Path, which uses the Playwright browser automation library and pre-built skills without ever calling an AI model, so there is no per-action cost or delay from waiting on a model. For trickier, less defined tasks, an optional Slow Path can call GPT-5.6 to propose a next step, but LHIC still checks that proposal against its own rules, requires human approval for sensitive actions, and verifies the result actually happened before moving on. The project's documentation is explicit that this AI model is a helper for planning, not the thing actually in charge of execution. The project also controls native desktop actions across macOS, Windows, and Linux, such as opening apps, typing, or clicking, again requiring approval and a check afterward that the action really occurred. Security features include encrypted storage for cookies and session data, automatic removal of passwords and personal information from logs, and support for managing approval keys through cloud key management services. The code is organized as a monorepo with separate packages for schemas, browser automation, verification, tracing, memory storage, security, and a command line tool. Setup requires Node.js 24, installing dependencies, and downloading a local Chromium browser through Playwright. The README notes that the published npm package is an older version and points users to run the project from a checkout of this repository instead until a newer release is published. The Slow Path's use of GPT-5.6 is optional and only activates if the user supplies their own API key.

Yoink these prompts

Prompt 1
Walk me through installing LHIC and running its credential-free Judge Demo with npm run demo -- --safe.
Prompt 2
Explain the difference between LHIC's Fast Path and Slow Path execution.
Prompt 3
Show me how to enable the optional GPT-5.6 Slow Path with my own API key without exposing it in logs or traces.
Prompt 4
Help me understand the package structure of this monorepo, like packages/verifier and packages/security.

Frequently asked questions

wtf is lhic?

A local-first automation runtime that turns browser and desktop tasks into verified, approval-gated actions, using fast rule-based execution for common tasks and an optional GPT-5.6 helper for ambiguous ones.

What language is lhic written in?

Mainly TypeScript. The stack also includes TypeScript, Playwright, Node.js.

What license does lhic use?

No license is stated in the visible README content.

How hard is lhic to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is lhic for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.