askdown

A command that asks a person the questions an AI agent wrote into a Markdown file, in a desktop window.

A window shows the Markdown (links, images, video) with an input for each question. On Submit, the answers are printed to stdout as JSON and written back into the file under each question. The command blocks until then, so it works as an AskUserQuestion for agents that do not have one, such as Codex.

brew install --cask cyberneura/tap/askdown

Features

• Question types are multiple choice (text or pictures), free text, a point on an image or a video frame, a freehand drawing, a colour, and a span of an audio or video file
• A question is a fenced code block with the info string askdown, holding YAML. Everything else in the file is shown as Markdown around the questions
• Exit codes tell the outcome (0 = answered, 1 = error, 2 = closed without submitting, 3 = timed out)
• --list prints the questions without opening a window, --no-write keeps the answers on stdout only, and --timeout limits the wait
• Code blocks wrap their long lines and have a button that copies their text

Requirements & notes

• Binaries are published for macOS on Apple Silicon and x86_64 Linux. The window uses the system webview, so Linux needs libwebkit2gtk-4.1 and GTK 3.
• Open source under the MIT License.