IF Commons GitHub

Ergonex

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.

FactValue
Version0.5.7
Conformance levelL1
Distributedgithub, npm
LicensePolyForm-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

FolderWhat it isMay 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

Titles, headings, exports, tables, columns and requirements. Esc closes.