assay

any model, verified

Run an AI agent on a real project — and verify the result.

assay runs any model — cloud, local, or your Claude/Cursor CLI — against your codebase and tools, then checks the work with real builds, tests, and commands before it calls anything done.

Download for macOS Apple Silicon · .dmg Windows coming soon Install the CLI terminal · macOS / Linux

Install (CLI)

One line in a terminal. Needs Node 18+. No GitHub, no account.

curl -fsSL https://assay.qbcsys.com/install.sh | sh

Installs the runtime in ~/.assay and the assay command in ~/.local/bin. Rich terminal UI: assay --tui.

Setup

Desktop app: just open it — the Setup screen picks your model and takes your key, then use Chat or Run a task. No commands. In a terminal:

  1. Run it. Type assay to start.
  2. Pick a model. Use :setup — OpenAI, Anthropic, Gemini, Ollama (local), or your Claude / Cursor CLI.
  3. Save a key. :key sk-… stores it in ~/.assay/config.json. Skip it for local or CLI providers.
  4. Connect tools. :connect wires in MCP servers — databases, mail, files, SSH.

In the terminal UI (assay --tui) these are slash commands, not colon — see below.

How to use it

Type to chat. Use :run when the work has to actually pass.

# just ask — the agent can read code and use your tools
what does this project do?

# verified work — multi-step, and re-checked by real commands
:run add a /health route and make the tests pass
✓ verified — build + tests passed

# manage runs
:jobs     # recent tasks
:resume   # continue an interrupted run
:trace    # step-by-step audit

Full command list any time with :help · interactive menu with :menu.

Terminal UI

Want a richer terminal? Run assay --tui — markdown, syntax highlighting, attachments, and clipboard paste. Same config and keys.

assay --tui            # or the installed: assay-tui

# commands here are slash, not colon:
/model <name>      /provider <name>
/key sk-…          /host <url>
/attach file.png    /paste    /copy all
/new    /yolo    /help

The TUI is chat-only. Verified :run jobs and tool setup (:connect) live in the plain assay CLI — all three share ~/.assay/config.json.

Quick links

macOS app (.dmg) install.sh CLI bundle (.tar.gz) Terminal UI (.tar.gz) engine providers validators