Just another harness.

0 npm dependencies Node 18+ 0 internet required

Open the console sign in to an existing account

objective  "Update my website."

requested from   ChatGPT
planned by       Assay
executed through Cursor + Fireworks
run on           devops
verified by      independent gates

◆ completed  no provider or execution path specified

Quick start

Needs node (18 or newer) and nothing else. The installer drops the engine into ~/.assay and links assay into ~/.local/bin.

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

Install. Fetches the engine files, links assay, and (if npm is present) the optional Ink/React rich TUI as assay-tui. Set ASSAY_NO_TUI=1 to skip it — the core CLI never needs npm.
Pick a model. First run prompts you. Keys are saved to ~/.assay/config.json with /key <your-key> — or skip keys entirely and point at a local Ollama.
Work. Type anything for a chat turn with tools; :run <task> for the gated, resumable, step-streaming machinery.
Go remote (optional). assay login then assay serve — the machine dials out to the console and appears under Sessions. No tunnels, no inbound ports.

# clone and link the CLI (idempotent — re-run to update)
git clone https://github.com/QBCSystems/mcp-tools.git
cd mcp-tools && sh install-agent.sh

Overrides: UAGENT_HOME (checkout dir, default ~/.universal-agent-harness), UAGENT_BIN (link dir, default ~/.local/bin), UAGENT_REPO, UAGENT_BRANCH. It links both agent and assay at the same CLI, so uninstall is rm ~/.local/bin/agent ~/.local/bin/assay plus the checkout dir. The repo's MCP tool servers install separately with ./install.sh.

# any provider — local Ollama, Ollama Cloud, OpenAI, Anthropic, Gemini, vLLM…
EDIT_PROVIDER=ollama EDIT_MODEL=gemma4:31b \
EDIT_API_HOST=https://ollama.com EDIT_API_KEY=... \
node universal-agent.cjs --workdir ./project \
  --task "Build X and verify it." --validate-file gate.json

# resume, inspect, dry-run, probe the provider
node universal-agent.cjs resume <task-id>
node universal-agent.cjs timeline <task-id>
node universal-agent.cjs plan --workdir ./project --task "..."
node universal-agent.cjs probe

Every setting resolves CLI flag > env var > project config > user config > default. init scaffolds a committable universal-agent.config.json (secrets deliberately left out).

Contact us

Tell us what you're building and how you'd want to use assay. We read every one.