Skip to main content
Gainable isn’t only a web app. The Gainable CLI (gaia) lets you build, refine, and publish apps from your terminal — and the same CLI powers official plugins for Claude Code and OpenAI Codex, so your coding agent can drive the Gainable harness for you.

The CLI (gaia)

A small command-line client for the Gainable harness. Build new apps, refine existing ones, import spreadsheets, and publish — all over HTTP, same pipelines as the web UI.

The plugins

Install the CLI once, then add the Gainable plugin to Claude Code or Codex. The agent learns when and how to call gaia for you.

​
Why use it?

Stay in your editor

Refine an app without leaving your coding agent — “add a probability column to the deals table” becomes one command the agent runs for you.

Scriptable & headless

Every command prints JSON to stdout. Wire Gainable into scripts, CI, or your own tooling.

Same harness, same quality

The CLI talks to the exact same planner, Build Agent, and validators as the web app. Nothing is downgraded.

Works in both agents

One package, two ecosystems. The plugin behaves the same in Claude Code and Codex.

​
Two modes

The plugin gives your agent two ways to work on an app. Most of the time you want the first one.

Chat mode (default)

The agent relays your request to the Gainable harness (gaia chat / gaia build). The planner and Build Agent do the work server-side in one cheap turn — the same path as typing in the web app. Use this for almost everything: “add KPIs”, “fix this bug”, “change the layout”, “build me a CRM”.

Code mode (opt-in)

The agent authors app code itself (gaia code): it pulls a local mirror of your app plus the build conventions, edits files, runs the same validators the Build Agent uses, and pushes. Use this only when you explicitly want the agent to write the code — “code it yourself”, “without the harness”.
These modes map to the two skills the plugin installs — gaia (chat mode) and gaia-code (code mode). You don’t invoke them by name; your agent picks the right one from what you ask. Lead with chat mode and only reach for code mode when you want hands-on control.

​
How it fits together

You ──▶ Claude Code / Codex ──▶ gaia CLI ──▶ Gainable harness ──▶ your app
         (the plugin's skills)   (npm package)   (planner + Build Agent)
  1. You describe a change in your agent’s chat.
  2. The plugin’s instructions tell the agent to run the right gaia command.
  3. gaia calls the Gainable server over HTTPS with your API key.
  4. The harness builds or edits your app and streams progress back.

​
When to use what

You want to…Use
Click around and chat in a browserThe web app
Drive Gainable from a script or terminalThe CLI directly
Refine an app from inside Claude Code or CodexThe plugin (chat mode)
Have your agent hand-write app code with Gainable’s guardrailsThe plugin (code mode)

​
Next steps

Install the CLI

Install @gainable.dev/cli and authenticate.

Claude Code plugin

Add Gainable to Claude Code.

Codex plugin

Add Gainable to OpenAI Codex.

Command reference

Every gaia command, flag, and exit code.