Skip to content

Configuration

Jump to bottom
Felipe Marzochi edited this page Jul 14, 2026 · 1 revision

Configuration

Install profiles

egc install --profile <name> selects a bundle of install modules, defined in manifests/install-profiles.json:

Profile Description
minimal Low-context setup: rules, agents, commands, platform configs, and quality workflow support, no hook runtime
core Minimal baseline plus commands, hooks, platform configs, and quality workflow support
developer Default engineering profile for most EGC users working across app codebases
security Security-heavy setup with baseline runtime support and security-specific guidance
research Research and content-oriented setup for investigation, synthesis, and publishing workflows
full Complete install with every currently classified module

Inspect what a profile resolves to before installing:

egc plan --profile developer --target cursor
egc catalog profiles
egc catalog components --family language
egc catalog show framework:nextjs

Install targets

--target selects which AI tool to install into. Valid values match the harness target ids in Supported-Tools: claude, cursor, antigravity, codex, gemini, opencode, codebuddy, windsurf, amp, copilot, zed, continue, plus egc for the generic/base install. Kiro and Trae are installed through their own .kiro/install.sh and .trae/install.sh scripts rather than the --target flag.

State and memory

  • State files: ~/.egc/state/<project-slug>/<branch>.md, one per project per git branch, encrypted at rest with AES-256-GCM. The encryption key lives at ~/.egc/encryption.key.
  • Legacy flat state files (pre-branch-scoping) are still read as a fallback.
  • egc status --json queries the SQLite state store status summary. egc overview gives a read-only aggregated view across every project.

Environment variables

Variable Purpose
ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY Enable semantic (LLM-based) routing in orchestrate_task and semantic session-intent detection. Without any of these, EGC falls back to local keyword scoring and lifecycle hooks still guarantee state is saved.
EGC_SESSION_ID Session identifier used by hooks; sanitized out of transcript logs.
GEMINI_TRANSCRIPT_PATH Transcript path for the Gemini backend; sanitized out of logs.
EGC_STOP_SAVE_INTERVAL_MINUTES Throttles the end-of-reply save reminder (default: once per project every 30 minutes). Set to 0 to prompt on every stop.
TRAE_ENV=cn Switches the Trae install target to the ~/.trae-cn/ path.

Telemetry

Opt-in, asked once on the first run of egc install, egc init, or egc doctor. Sends EGC version and OS platform only, no project data or identifiers.

egc telemetry status
egc telemetry off

Dashboard

Local dashboard at http://localhost:7890, started automatically by egc init:

egc dashboard
egc dashboard stop
egc dashboard status

Hooks

Hook manifest at hooks/hooks.json; implementations live under scripts/hooks/. Hook types: PreToolUse, PostToolUse, SessionStart, Stop. egc-guardian's validate_command and validate_write are wired in as PreToolUse hooks in every installed target so every shell command and file write is checked before it runs.

Team memory sync

egc team (backed by the team_init, team_sync, team_status tools in egc-memory) syncs lessons and decisions across teammates via a git remote:

egc team init --remote git@github.com:org/egc-memory
egc team sync
egc team status

Budget guardian

egc budget enforces per-session token and cost limits at the PreToolUse hook layer; commands are blocked when the configured budget is exceeded.

Plugins

egc plugin installs, lists, removes, or updates community skills, agents, or rules bundles from npm or a local path.

Clone this wiki locally