Reference
Configuration files under ~/.gjc, .env resolution order, and the full set of settings, models, credentials, environment variables, keybindings, and theme controls for Gajae-Code.
This section is the runtime reference for Gajae-Code (gjc). It covers the files under ~/.gjc, how environment variables are resolved, and links to the detailed pages for configuration, credentials, keybindings, and theme.
Configuration files
Gajae-Code reads configuration from ~/.gjc (override the root with GJC_CONFIG_DIR):
| Path | Purpose |
|---|---|
~/.gjc/config.yml | General runtime settings (e.g. retry budgets). |
~/.gjc/agent/models.yml | Providers, models, roles, and routing. |
~/.gjc/agent/.env | Agent-scoped environment variables. |
~/.gjc/.env | Config-root environment fallbacks. |
~/.env | Home environment fallbacks. |
GJC_CODING_AGENT_DIR can fully override the agent directory (default ~/.gjc/agent), independent of GJC_CONFIG_DIR.
.env resolution order
Most runtime lookups use $env, which loads .env files in this order — each step only fills keys not already set:
Bun.env)..env ($PWD/.env)..env (~/.gjc/agent/.env, respecting GJC_CONFIG_DIR / GJC_CODING_AGENT_DIR)..env (~/.gjc/.env, respecting GJC_CONFIG_DIR)..env (~/.env).What's in this section
Quick map
- Configuration — the
~/.gjclayout,config.ymlretry budgets, and storage/behavior toggles. - CLI — launch, provider setup, research mode, team execution, and ultragoal command shapes.
- Models & credentials —
models.yml, provider presets, model roles, and auth resolution. - Tools — file, search, runtime, computer-use, web, session, and media tools.
- Environment variables — categorized tables of provider keys, base-URL overrides, web-search keys, and toggles.
- Keybindings — the interactive bindings reference.
- Theme — the GJC red-claw default and how to override it.
Treat every *_API_KEY, *_TOKEN, OAuth/bearer credential, and cloud credential (AWS_*, GOOGLE_APPLICATION_CREDENTIALS) as a secret — never log or commit them.
critic
Read-only plan critic. The skeptic that approves only actionable, verifiable plans — finding gaps, risks, and non-executable steps before execution begins.
Configuration
The ~/.gjc layout, config.yml retry budgets and fail-fast cases, and the storage and behavior environment variables that shape how Gajae-Code runs.