enigma-cli weekly downloads statistics

enigma-cli

Everything you need to work with a coding agent, in one command. enigma installs a shared set of engineering policy skills into the agents you actually use (Claude Code, OpenAI Codex, opencode, Kimi Code) and sets up portable git security hooks that block secrets, .env files, and dependency dirs from being committed.

Install

One command. It installs or updates the enigma command to the latest version, then runs enigma install interactively so you choose what to set up. Re-run it anytime to update:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/FJRG2007/enigma/main/scripts/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/FJRG2007/enigma/main/scripts/install.ps1 | iex

Or one-shot, no global install, no prompts - deploy the skills to every supported agent at user level:

npx enigma-cli@latest install --all --yes

That first install is the only one you ever need to run by hand: afterwards, launching a tool through enigma (e.g. enigma claude) auto-syncs the deployed skills and memory with the installed package version (see Auto-sync).

Requirements

Minimum: Node.js >= 18 (with npm), Git and at least one coding agent. Recommended: add Claude Code, the GitHub CLI, Bun and Warp.

<details> <summary><b>Details</b> - what each one is for</summary>

Minimum

<a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js"/></a>	>= 18, ships with npm - installs and runs the enigma CLI
<a href="https://git-scm.com"><img src="https://img.shields.io/badge/Git-F05032?style=for-the-badge&logo=git&logoColor=white" alt="Git"/></a>	powers the security hooks and the commit guard
<img src="https://img.shields.io/badge/Coding%20agent-555555?style=for-the-badge&logo=claude&logoColor=white" alt="Coding agent"/>	at least one of Claude Code, OpenAI Codex, opencode or Kimi Code - the skills need a home

Recommended

Everything in Minimum, plus:

<a href="https://claude.com/claude-code"><img src="https://img.shields.io/badge/Claude%20Code-D97757?style=for-the-badge&logo=claude&logoColor=white" alt="Claude Code"/></a>	the agent enigma is most battle-tested with
<a href="https://cli.github.com"><img src="https://img.shields.io/badge/GitHub%20CLI-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub CLI"/></a>	gh commits go through the same hooks, and enigma issue opens prefilled reports
<a href="https://bun.sh"><img src="https://img.shields.io/badge/Bun-000000?style=for-the-badge&logo=bun&logoColor=white" alt="Bun"/></a>	only needed to build or contribute from source
<a href="https://www.warp.dev"><img src="https://img.shields.io/badge/Warp-01A4FF?style=for-the-badge&logo=warp&logoColor=white" alt="Warp"/></a>	a modern terminal where the hub TUI shines

</details>

Commands

enigma                 Interactive menu: choose features to set up
enigma install         Install/update agent skills
enigma security        Set up git security hooks in the current repo
enigma guard [--all]   Run the commit guard: staged files, --all for all tracked, or
                       --range <base>..<head> for what a commit range touched (pre-push,
                       CI). --json emits one document; exits 1 on findings, 2 if it
                       could not run at all
enigma config [k v]    Show or set runtime toggles (e.g. config commit-emoji off)
enigma <tool> [acct]   Launch claude | codex | opencode | kimi with an account
                       (resolution: explicit > active profile > tool active);
                       auto-syncs deployed skills first
enigma account ...     Manage per-tool accounts (list/add/use/login/remove)
enigma profile ...     Group one account per tool (list/add/use/set/unset/remove)
enigma skills ...      List skills and manage discards (list/discard/restore)
enigma compress [file] Compress JSON/logs/text to fewer tokens (reversible via CCR);
                       --retrieve <hash> restores, --stats shows total savings,
                       --clear wipes all dashboard data (stats/history/cache)
enigma verify          Check that work reported as finished actually is: scans the change for
                       unfinished work and runs your verification command. parity <src> <dst>
                       compares a codebase against a port of it. --json emits one document;
                       exits 1 on findings, 2 when the check could not run. Also runs at turn
                       end, where it additionally checks the reply itself against your
                       output-style level
enigma design <src>    Reverse-engineer a design system from a URL, a project folder or a git
                       repo into DESIGN.md and an agent skill installed for your agents
                       (--ultra: screenshots, motion and hover states via a local Chrome/Edge)
enigma mcp             Run the context-compression MCP server over stdio
enigma dashboard|dash  Open the local dashboard (manage enigma; see savings) in your browser (http://enigma,
                       or http://localhost:24282 if :80/hosts is unavailable)
enigma ssh [alias]     SSH connection manager: connect by alias, or list | add | edit | remove |
                       info; tunnels are standalone: tunnel add <name> <server> <spec>,
                       tunnel start|stop <name>, tunnels (list with live status)
                       (encrypted passwords, saved key/jump/port-forwards; e.g. 9090:db:5432)
enigma seal…