DOCUMENTATION / DEVELOPMENT OVERVIEW
Understand the
intended workflow.
Start with the architecture and its boundaries. Installation and operational instructions will follow a verified release.
From proposal to review
gxrun is being developed as a local-first control center for applications built with AI. Its intended workflow separates creating a proposal, approving an exact plan and observing execution.
- Prepare a proposal. An AI client or CLI describes the requested change. A proposal alone grants no authority.
- Review the complete plan. The intended review shows the target, ordered steps, warnings, immutable inputs and complete plan hash.
- Approve locally. Only a trusted native review or deliberate interactive CLI review on the paired Mac may authorize privileged execution.
- Observe and reconcile. Planned run records and receipts must distinguish success, failure and unknown outcomes.
This describes design intent. Deployment, native approval and runtime behavior are not available from this site.
Different surfaces, different authority
- Public website
- Static information only. No account, server connection, license import or approval inputs.
- Customer-local panel
- Planned to run on the customer’s computer. A browser can request review; it cannot grant privileged approval.
- AI and MCP clients
- Planned to propose, read and dispatch already approved work within granted capabilities. AI has no approval authority.
- Server panel
- Planned for access through an explicit SSH tunnel. A connection does not grant deployment authority.
Planned platforms
| Surface | Intended scope | Current status |
|---|---|---|
| Controller | macOS native app | Unavailable |
| Other clients | Linux and Windows CLI, browser and MCP workflows; no node-plan approval | Unavailable |
| Node targets | Ubuntu 24.04 x64 and Amazon Linux 2023 arm64 on EC2 | Unverified; no artifacts |
These are intended targets, not a support promise. Release-specific downloads and tested compatibility must be published together.
Before an install guide
A release needs verified runtime behavior, trusted local approval, signed distribution and platform-specific evidence. No installation command is offered while that work remains pending.