The one command, ergonex, that manages a team's workspace: the repositories laid out like their remotes on GitHub, GitLab or plain Git behind one interface, with a plan shown before anything changes, the pinned tools, the generated files and hooks, the shell, and the checks of a workspace (doctor, status, verify). It runs on Windows, macOS and Linux, on Bun by default and on Node 26 as the backup, and is written to be installed from npm by a person who has never set up a repository. The first real program on Headless: its commands are governance actions with reach policies, run through the command-line surface. A library of commons with its own specifications.
| Fact | Value |
|---|
| Version | 0.5.7 |
| Conformance level | L1 |
| Distributed | github, npm |
| License | PolyForm-Noncommercial-1.0.0, source-available: free for noncommercial use, commercial use needs a license from the owner (see Licensing in Start here) |
| Import it as | @intellectual-frontiers/ergonex |
#Areas
#Imports
Core, Crypto, Formats, Githost, Headless, Mizan, Net, Quality, System, Telemetry, Terminal, Test
#Specifications
#Folders
| Folder | What it is | May import |
|---|
spec-kit/ | The library's own specifications, numbered from 0001. | nothing: Markdown and TSV |
src/ | The program ergonex.ts, its commands (declared on Headless in commands/, with the tree in commands/program.ts), the plan and the host: the pure core (the plan, the findings, the manifest, the layout) and the host layer that reads files, runs programs and writes evidence. | the kernel, the runtime and the Git host of commons, by package name; Headless only from commands/ and ergonex.ts, by its exports |
src/platform/ | What this library uses of the runtime and the kernel's namespaces, each name once, by package name. | the runtime and the kernel, by package name |
bin/ | The launcher the package's bin names: it registers the hook that lets Node 26 run TypeScript, then the controller. | src/ |
tools/ | The check bun run verify runs: the trace of sources and tests to the specifications. | the kernel and the runtime, by package name |
suite/ | The tests, which run the real programs and a real git, never stand-ins. | src/; the runtime's test module, by package name |
#Quality
Quality: 197 tests: 197 passed, 0 failed, 0 skipped, 115 of 126 requirements proved, 10 findings held, 0 open issues, 1 open ticket. The tests and issues of the library