From e95273e1b33dd1183f212b5d75ebbc4583c43668 Mon Sep 17 00:00:00 2001 From: Ruslan Strazhnyk Date: Thu, 5 Nov 2026 11:16:55 +0100 Subject: [PATCH] docs: position qmax-code as a standalone IDE --- AGENTS.md | 27 +++++++++++++++++---------- CLAUDE.md | 16 +++++++++++----- README.md | 43 +++++++++++++++++++++++++++---------------- doc.go | 8 +++++--- 4 files changed, 60 insertions(+), 34 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 1164b68..77dcead 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 @@ -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 diff --git a/CLAUDE.md b/CLAUDE.md index a9edc77..bf3a118 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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. diff --git a/README.md b/README.md index eef4262..031cc56 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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), @@ -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 @@ -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 @@ -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).** diff --git a/doc.go b/doc.go index 89a246b..e5be114 100644 --- a/doc.go +++ b/doc.go @@ -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: //