Grow CLI

GrowthCircle coding agent for your terminal. Built on OpenAI Codex CLI, powered by models from GrowthCircle AI — one API key, free and paid models included.

Install

npm install -g @growthcircle/growcli

Supported platforms: Linux x64 · macOS x64 · macOS arm64 · Windows x64

Quick start

growcli                              # interactive agent (prompts for API key on first run)
growcli -m MODEL_ID                  # use a specific model
growcli exec "explain this repo"     # one-shot task

Set your API key (optional — growcli prompts on first run if unset):

export GC_API_KEY="your_growthcircle_api_key"

Install from source

git clone https://github.com/Growth-Circle/growcli.git
cd growcli/codex-rs
CODEX_SKIP_VENDORED_BWRAP=1 cargo install --path cli --bin growcli --locked

Or run without installing:

cd growcli/codex-rs
cargo run --bin growcli -- --help

GrowthCircle provider

Grow CLI defaults to the built-in growthcircle provider:

Setting	Value
Base URL	https://ai.growthcircle.id/v1
Auth	Authorization: Bearer $GC_API_KEY
Agent endpoint	POST /v1/responses
Chat endpoint	POST /v1/chat/completions
Image endpoint	POST /v1/images/generations

All models available to your account (free and paid) are selected with -m MODEL_ID or in config:

model_provider = "growthcircle"
model = "MODEL_ID"

Save in ~/.codex/config.toml or pass on the command line.

GrowthCircle remains the default provider. To try another OpenAI-compatible Chat Completions backend, add a separate custom provider and point Grow CLI at it only when you want to use it:

model_provider = "custom-openai-chat"
model = "MODEL_ID_FROM_PROVIDER"

[model_providers.custom-openai-chat]
name = "Custom OpenAI-compatible Chat"
base_url = "https://provider.example/v1"
env_key = "CUSTOM_OPENAI_API_KEY"
wire_api = "chat"
requires_openai_auth = false

Set CUSTOM_OPENAI_API_KEY in your shell and swap MODEL_ID_FROM_PROVIDER with any model ID accepted by that provider. GrowthCircle models continue to use the built-in growthcircle provider and GC_API_KEY.

Documentation

• GrowthCircle setup
• Sample config
• Installing & system requirements
• Contributing

Upstream

Grow CLI tracks upstream OpenAI Codex CLI where practical. Fork-specific changes: GrowthCircle provider defaults, GC_API_KEY auth, and the growcli / grow commands.

License

Apache-2.0 — see LICENSE. Upstream attribution preserved in NOTICE.