Getting Started

Create a RootCX workspace, connect the assistant you already use, and deploy your first app. RootCX provides the database, authentication, permissions, audit trail, and runtime before you write application code.

1. Create a workspace

Create a project in RootCX Cloud. When provisioning completes, choose your AI assistant from the onboarding screen. New workspaces start without a sample business app so the first deployed app reflects your own use case.

2. Connect your assistant

In ChatGPT Desktop Work, install RootCX from the Plugin Directory, select Connect, then sign in and choose the workspace the assistant may use. The plugin handles the official MCP connection and OAuth flow; do not copy endpoints or access tokens into ChatGPT.

For Claude Code, Codex, and other coding agents that support the open Agent Skills format, install the same RootCX skill:

npx skills add rootcx/rootcx-skills -g -y

MCP and the skill have different responsibilities: MCP authenticates the user and exposes governed RootCX context and data actions. The skill installs and uses the local CLI to scaffold, build, test, and deploy applications without sending their source through MCP.

3. Describe the outcome

Start with the result rather than technical implementation:

"I need a CRM for our sales team to manage contacts, companies, and deals. Managers can delete deals; representatives can read and update them."

In ChatGPT Desktop Work local mode, the RootCX skill installs the CLI when needed. It asks for the intended users and required information, restates the user story, builds in the local workspace, validates the manifest, and asks for confirmation before running rootcx deploy.

4. Open the live app

After deployment, the assistant returns the exact live URL. Open it and try the primary workflow. This first successful deployment is the onboarding activation event shown in your RootCX workspace.

Manual CLI workflow

The plugin normally handles these commands. Run them yourself only when you want a terminal-first workflow:

curl -fsSL https://rootcx.com/install.sh | sh
rootcx auth login https://<your-ref>.rootcx.com
rootcx new my_app
cd my_app
rootcx deploy

Self-hosting

git clone https://github.com/rootcx/rootcx.git
cd rootcx
docker compose up -d
rootcx auth login http://localhost:9100

Local HTTP environments support bearer authentication for development. Production MCP connections should use the OAuth flow advertised by the tenant.

Next steps

• Build an Application for manifests, frontend SDK, and backend handlers.
• Claude Code and skills for coding-agent setup.
• Authentication for identity and SSO.
• CLI Reference for local and automated workflows.