AskHuman开源AI工作流

Install

```bash

Usage

Screenshots

Your agent's questions arrive at the local GUI popup and Telegram, Slack, DingTalk, and Feishu all at once, along with the key context, attachments, and preset options — so whether or not you're at your desk, you get notified and can reply anytime.

<p align="center"> <img src="assets/channels.webp" alt="Reply to your agent from the local popup, Telegram, Slack, DingTalk, or Feishu" width="900"> </p>

The tool automatically records the recent history of agent questions and human answers, so you can refer back to it anytime while answering new questions. (If you don't need history, you can turn it off in the settings.)

<p align="center"> <img src="assets/history.webp" alt="Browse message and reply history per project" width="680"> </p>

4. General settings

For general preferences such as theme, window behavior, speech input, and reply history, see General Settings.

Environment variables

For the available environment variables, see Environment Variables.

Program integration

Add askhuman to your project (npm i askhuman); npm install pulls the current platform's binary, and at runtime you resolve the path and call it:

import { getBinaryPath, isAvailable } from "askhuman";
import { spawnSync } from "node:child_process";

if (isAvailable()) {
  const r = spawnSync(getBinaryPath(), ["Continue?", "-o", "Continue", "-o", "Stop"], { encoding: "utf8" });
  if (r.status === 3) { /* no available channel: degrade without blocking */ }
  else if (r.status === 0) { /* parse the result blocks from r.stdout */ }
}

Exit codes: success / cancel is 0; no available channel is 3; other errors are 1. Custom source name: set ASKHUMAN_ENV_SOURCE_NAME=Agent, and the popup title and channel message headers become Question from Agent.

The most basic ask: the first argument is the question, -o adds an option

AskHuman "Continue?" -o "Continue" -o "Stop"

With an image and multiple questions: the first argument is a shared description,

-f attaches a file/image, each -q is a question, -o! marks the recommended answer

AskHuman "Take a look at this change?" -f ./diagram.png \ -q "Continue?" -o! "Continue" -o "Stop" \ -q "Run the tests?" -o "Run" -o "Skip"