The command line

Grux can be set up and driven entirely from the terminal, without opening a window. Shipped in 1.2.0, and the reason is not that a terminal is faster.

Rendered unchanged from the Grux README at commit 86963f2, fetched 2026-11-01. If this page and the repository disagree, the repository is right.

It is that the coding agent already sitting in that terminal can do the work with you: install Grux, wire it into the rest of your machine, and go on extending it long after setup is done.

Start here. One command, nothing to install first:

npx @dotcomjack/grux

That finds Grux.app, puts grux on your PATH, and runs setup. After the first run, drop the npx. The launcher is a dependency free shim that only locates the binary and steps aside, so there is one implementation of everything below and no second front door to drift. Details in npm/README.md.

The binary itself lives at Grux.app/Contents/MacOS/grux-cli, so you can link it by hand instead if you prefer:

ln -s /Applications/Grux.app/Contents/MacOS/grux-cli ~/.local/bin/grux

grux setup                 # the whole first run, unattended
grux status --json         # what is configured, what is missing
grux doctor                # what is wrong, and what to do about it
grux why <feature>         # why a feature says it needs setup

• Every command runs unattended. A flag for every choice and JSON on every read, so nothing hangs waiting for a prompt an agent cannot see.
• Every command can print itself as a prompt instead of running, so you can hand the job to whichever coding agent you already use rather than translating it yourself.
• An MCP bridge, so an agent that speaks it can drive Grux through the same tools you do.
• Reads answer with Grux closed. They come from files on disk. Writes go over a Unix socket at 0600, so Grux still opens no network port.

The full surface, every command and every exit code, is in Grux-Mac/docs/cli-grammar.md.

Related

• First run
• Permissions, and what each one buys
• Build on it
• Privacy posture

Free, MIT licensed. macOS 14 or later, Apple silicon. 28.4 MB, signed and notarized by Apple. No account, no server, no subscription.