Configuration
Settings live in .enigma.json (global ~/.enigma.json, overridden by a repo-local one). Set them with enigma config <key> <value>, the interactive menu (enigma config), or the dashboard. Add -g / -l to target global or local.
| Key | Values | Default | What it does |
|---|---|---|---|
commit-emoji | on / off | on | Leading gitmoji on commit subjects, the agent’s and the gate’s. |
output-style | off / lite / full / ultra | off | Compress the agent’s chat prose (memory-file section; restart the agent). Enforced, not just asked for: the verify Stop hook scans the final reply for filler, a preamble, and status rows that pad a table, and denies the stop on the ones it can catch precisely. |
minimal-code | off / lite / full / ultra | full | Anti-overengineering intensity for code the agent writes. |
permission-bypass | on / off | on | Skip the agent’s approval prompts (a deliberate security downgrade). |
claude-trust | on / off | on | Pre-answer Claude Code’s “Is this a project you trust?” prompt for any path, so it stops asking in every new folder (and in your home directory, where Claude never remembers the answer). Also a deliberate security downgrade: that prompt is what makes you look at unfamiliar code before an agent runs in it. Turning it off keeps the folders you already trusted. |
resource-cap | 1 - 100 | 60 | Share of the machine work an agent runs may take: cores, build concurrency, and a lowered scheduling priority so your own work stays responsive. Bulk file work also drops to idle priority. |
low-memory-cap | 1 - 100 | 80 | On a machine with 16 GB of RAM or less, the memory use above which an agent stops launching heavy work instead of throttling it; the cap above is also halved there. Global-only: it describes the machine, not a repo. |
auto-sync | on / off | on | Refresh deployed skills when launching a tool through enigma. |
statusline | on / off | on | Show the enigma badge, model, context and cost in Claude Code’s status bar, plus live gate progress during a run. |
statusline-refresh | <0-60> | 10 | Seconds between status bar refreshes. Every tick starts a new process, so raise it where that is slow; 0 removes the timer and refreshes only when the conversation moves (the gate line then stops animating during a run). |
remote-skills | on / off | on | Fetch skills newer than the bundled set from GitHub. |
skill-update-policy | overwrite / keep | overwrite | On update, replace a skill you edited locally, or keep your edits. |
usage-api | on / off | off | Fetch the real usage %/reset from Anthropic via your local Claude Code login. |
parallel-subagents | on / off | off | Allow the agent to fan out sub-agents in parallel. |
auto-lint | on / off | off | Lint edited files via a post-write hook. |
guardrails | on / off | on | Enforce project conventions (UUID keys, Prisma as default ORM, …) via a post-edit hook that feeds violations back to the agent, plus a turn-end sweep of the lines the change added for the rules that only apply to new code. Set guardrails: false in a repo’s .enigma.json to stand that sweep down there. enigma guardrails stats reports which rules keep being broken. |
trim | on / off | on | Remove the blank line agents leave at the end of a file, after each edit and on the staged files at commit time. Only a file with content followed by blank lines is touched. |
verify | on / off | on | Check a “this is finished” claim against what the turn actually produced, and deny the stop when the evidence contradicts it. The same hook sweeps the added lines for guardrail violations, claim or no claim; checks the reply itself against the output-style level; and - where the quality gate is on - denies a stop that reports the gate as skipped or leaves committed work no gate run has seen. Global; to skip one project put verify: false in its .enigma.json. |
verify-command | command | (none) | Command the completion gate runs before a “done” claim is allowed through (e.g. npm test). Global-only, and carried by neither a config export nor an import. |
compress | on / off | off | Register the context-compression MCP server in your agents. |
code-graph | on / off | off | Expose enigma’s native code-graph tools (index a codebase into a knowledge graph of symbols/imports/references) to your agents over MCP. |
dashboard | off / on-demand / always | off | Local management dashboard mode. |
dashboard-port | <0-65535> | 0 | Preferred dashboard port (0 = auto: 80, then 24282). Restart the dashboard to apply. |
dashboard-bind | loopback / lan / custom | loopback | Which interface the dashboard listens on. Anything but loopback is reachable from the network and refuses to start without a token. Restart to apply. |
dashboard-bind-address | <ip> | (unset) | Interface to bind when dashboard-bind is custom (e.g. a Tailscale IP). |
api-port | <1-65535> | 8000 | Default port for the local OpenAI-compatible API server (enigma api). A –port flag overrides it per run. |
proxy | on / off | off | Route enigma claude through a local measuring proxy. |
prompt-secret-guard | on / off | off | Scan outgoing prompts for secrets (via the proxy). |
prompt-secret-mode | redact / reject | redact | What the guard does on a detected secret. |
usage-stats | on / off | off | Read your Claude Code transcripts for real token usage and cost. |
recall | on / off | off | Build a searchable local memory of your coding sessions from transcripts; exposed to agents over MCP. |
recall-llm | on / off | off | Enrich recall observations with an LLM via your local Claude login (Claude Code only; uses a little quota). |
gate | on / off | on | The experimental AI quality gate (the /gate command and enigma gate). Agents auto-drive it once a code task is committed, on whatever branch it is on - no need to ask or run enigma gate init. Turn it off per project with gate: false in that repo’s .enigma.json (or /gate off from your agent), everywhere with enigma config gate off -g. See Quality gate. |
gate-protected-branches | <branch names> | (none) | Branches the gate refuses to validate, matched exactly (add/remove one at a time). Empty means every branch is fair game, the default branch included - and there the pipeline opens no PR and pushes straight to the branch, so list it here when it must only be reached through review. |
gh-telemetry | enabled / disabled | disabled | GitHub CLI usage analytics. |
token-price | <usd> | 0 | $ per 1M input tokens for dashboard money estimates (0 = per-source defaults). |
token-speed | <tok/s> | 0 | Prefill speed for dashboard time estimates (0 = default). |
enigma config compress on
enigma config minimal-code ultra
enigma config dashboard always/improve
A slash command deployed to every agent (it runs inside the agent, not the CLI). Two modes: implement edits a focused area, advisor is read-only and writes self-contained plans for another agent to execute.
/improve ui # implement: ui | security | performance | seo | refactor
/improve audit # advisor (read-only): audit | quick | deep | branch | next | plan ...