Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 17 additions & 10 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,20 +4,26 @@ Instructions for coding agents working on qmax-code.

## What this is

qmax-code is a terminal **QA** agent that can also host coding CLIs. It runs
standalone on a local repository or connected to QualityMax. Through `/orch`
it can launch Claude Code, Codex, Antigravity, or OpenCode while keeping qmax tools and
terminal UX — or run the built-in loop on Anthropic, Cerebras, or Ollama.
qmax-code is evolving into a **standalone IDE with optional, first-class
QualityMax connectivity through MCP**. The current Go terminal agent is the
foundation: it works on local repositories without a QualityMax account and
can connect to QualityMax for hosted QA workflows. Through `/orch` it can
launch Claude Code, Codex, Antigravity, or OpenCode while keeping qmax tools
and terminal UX — or run the built-in loop on Anthropic, Cerebras, or Ollama.

This repository is **Go 1.27.3+**, not TypeScript. The thing users install is one
compiled binary.

## Positioning

qmax-code is **not** a faster Claude and **not** an IDE. Cursor owns the
editor. Claude Code and Codex own general coding in a terminal. qmax-code owns
QA on the repo (crawl, generate/run tests, review, heal, receipts) and borrows
those other agents when the job is coding.
The product direction is an independent development environment for coding,
testing, review, and agent workflows. QualityMax is an optional integration
with first-class MCP support, rather than a prerequisite for using the IDE.
QA remains a core strength: crawl, generate/run tests, review, heal, and receipts.
Claude Code, Codex, Antigravity, and OpenCode are selectable coding backends.

Distinguish the IDE direction from capabilities shipped today. The current
release is a terminal application; describe planned IDE features as future work.

- **Go** = one-file install and instant TUI. It does not make tokens faster.
- **Cerebras** = fast inference (~1000–2000+ tok/s). Models today: GPT-OSS
Expand All @@ -28,8 +34,9 @@ those other agents when the job is coding.
- **OpenCode** = opt-in providers (Z.AI GLM, Groq, OpenRouter) via
`/providers`.

When writing copy or comments, say “the QA terminal that can switch
inference,” not “faster than Claude.”
When writing product-direction copy, say “a standalone IDE with optional,
first-class QualityMax connectivity through MCP.” Describe current terminal
capabilities accurately and attribute inference speed to the backend.

## Why Go

Expand Down
16 changes: 11 additions & 5 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,19 @@
# CLAUDE.md

qmax-code is a **Go** terminal **QA** agent (Go 1.27.3+). It ships as one
compiled binary: `curl | bash` installs a file, not a Node or Python runtime.
qmax-code is evolving into a **standalone IDE with optional, first-class
QualityMax connectivity through MCP**. Its current foundation is a **Go**
terminal agent (Go 1.27.3+). It ships as one compiled binary:
`curl | bash` installs a file, not a Node or Python runtime.
Claude Code, Codex, Antigravity, and OpenCode are separate subprocesses that `/orch` can
host; they are not this repository's runtime.

**Positioning:** not an IDE, not a faster Claude. Cursor owns the editor.
Claude Code / Codex / Antigravity own hard coding. qmax-code owns QA (tests, crawls, review,
receipts) and switches inference in `/orch`. **Cerebras** is the fast path
**Positioning:** an independent environment for coding, testing, review, and
agent workflows. QualityMax is optional, with first-class MCP connectivity;
using qmax-code does not require a QualityMax account. QA (tests, crawls,
review, receipts) remains a core strength. Describe the standalone IDE as the
product direction and the terminal app as what ships today; describe planned
IDE features as future work.
qmax-code switches inference in `/orch`. **Cerebras** is the fast path
(~1000–2000+ tok/s: GPT-OSS 120B, GLM 4.7, Gemma 4; **Qwen 3.8 coming soon**).
Do not add Qwen to the picker until Cerebras publishes the live model ID.

Expand Down
43 changes: 27 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,13 +26,18 @@

[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-support-yellow?logo=buymeacoffee)](https://buymeacoffee.com/qualitymax)

**The open-source QA terminal that can switch inference.** Named after Max, the real cat who inspired it all.
**Building an open-source standalone IDE with optional, first-class QualityMax connectivity through MCP.** Named after Max, the real cat who inspired it all.

qmax-code can work as a standalone local repository agent with no QualityMax
account, or connect to QualityMax for hosted QA workflows. In connected mode it
can manage projects and test cases, crawl sites, generate and run tests, review
repositories, heal scripts, and prepare CI. It calls the QualityMax API
directly, so the separate `qmax` CLI is optional.
qmax-code is evolving into an independent development environment for coding,
testing, review, and agent workflows. QualityMax is an optional integration,
with first-class connectivity through MCP as part of that direction.

Today, qmax-code ships as a Go terminal application that works on local
repositories without a QualityMax account. Connect to QualityMax to manage
projects and test cases, crawl sites, generate and run tests, review
repositories, heal scripts, and prepare CI. The current client calls the
QualityMax API directly and exposes tools to coding-agent backends through
its embedded MCP server; the separate `qmax` CLI is optional.

Use the built-in agent with Anthropic, Cerebras, or Ollama, or use
**orchestration mode** to run Claude Code, Codex, Antigravity, or OpenCode with the same qmax
Expand All @@ -46,7 +51,8 @@ for styling, and [Glamour](https://github.com/charmbracelet/glamour) for Markdow

![Five open QualityMax tools and where qmax-code sits among them](docs/img/family.svg)

qmax-code is the terminal agent that drives a QA session. It sits alongside
qmax-code brings local coding and QA workflows into one agent environment.
It sits alongside
[free-qa-skills](https://github.com/Quality-Max/free-qa-skills) (read-only
audits inside a coding agent), [qmax-mcp](https://github.com/Quality-Max/qmax-mcp)
(scan a page, generate a repro, run it locally),
Expand All @@ -61,11 +67,16 @@ cloud reach a private network). Only hosted QualityMax needs an account.

## Where it sits

qmax-code is the **QA terminal next to the repo**, not an editor and not a
faster Claude. Cursor owns the file buffer. Claude Code and Codex own general
coding in a terminal. qmax-code owns crawls, tests, review, healing, and
receipts — and can **host** those other agents through `/orch` when the job is
coding.
The goal is a **standalone IDE** where local development, coding agents, and
QA workflows share one environment. QualityMax connectivity through MCP is
optional and first-class: it extends the environment with hosted QA services
without making a QualityMax account a requirement for local work.

The current terminal application is the foundation for that IDE. It already
supports local file editing, commands, tests, and selectable coding backends.
Connected workflows add crawls, hosted tests, repository review, and healing.
The standalone IDE is the product direction; the capabilities documented
below describe the terminal release available today.

Go makes the binary install once. **Cerebras** makes tokens fast (today:
GPT-OSS 120B, GLM 4.7, Gemma 4 at ~1000–2000+ tok/s; **Qwen 3.8 coming
Expand All @@ -80,9 +91,9 @@ in `/orch`; do not run two CLIs and two configs.
| GLM on a coding plan | `/providers` → Z.AI, then OpenCode in `/orch` |
| Air-gapped / local weights | Ollama |

Day-to-day: the editor for typing, qmax-code for the agent. Default `/orch`
to Cerebras or Claude Code depending on whether the next hour is “generate
and run a lot” or “think hard.”
In the current terminal release, use `/orch` to select the backend for your
next task. Local coding works without QualityMax; enable connected mode when
you need its hosted QA workflows.

## What qmax-code can do

Expand Down Expand Up @@ -541,4 +552,4 @@ personality-free response style.

---

**Open-source QA terminal. Licensed under [Apache 2.0](LICENSE).**
**Building an open-source standalone IDE. Optional, first-class QualityMax connectivity through MCP. Licensed under [Apache 2.0](LICENSE).**
8 changes: 5 additions & 3 deletions doc.go
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
// Command qmax-code is a QA-focused AI terminal agent.
// Command qmax-code is the terminal foundation for a standalone IDE with
// optional, first-class QualityMax connectivity through MCP.
//
// It runs standalone against a local repository or connects to QualityMax,
// and can switch inference between the Anthropic API, Cerebras, Ollama, and
// hosted coding agents (Claude Code, Codex, Antigravity, OpenCode) through
// /orch. Its focus is QA work: generating and running tests, crawling apps,
// reviewing diffs, and recording receipts.
// /orch. It supports local coding, QA work, and exposure receipts. Connected
// workflows add test generation and execution, app crawling, and repository
// review.
//
// Install a release binary:
//
Expand Down
Loading