fractal-research-group

Canonical Fractal Research Group command line entrypoint.

Install the package once on a new machine, then use frg to discover FRG apps, Tailnet endpoints, local setup context, and agent-readable project directions.

npm install -g fractal-research-group
frg context --json
frg apps list
frg apps show clawdad

Naming

The package is named fractal-research-group and installs the binary frg.

Live npm checks on 2026-05-07 returned E404 for these package names:

• frg
• fractal-research-group
• @fractal-research-group/frg

Publishing [email protected] was blocked by npm package-name similarity policy on 2026-05-07. The global install path is:

npm install -g fractal-research-group

The package keeps the short command name:

{
  "name": "fractal-research-group",
  "bin": {
    "frg": "./bin/frg.js"
  }
}

Commands

frg apps list
frg apps show <id>
frg apps open <id>
frg apps doctor <id>
frg apps registry --json
frg bootstrap --json
frg doctor [--json]
frg setup [--json]
frg setup codex [--dry-run|--json]
frg context --json

Registry

The app registry lives at registry/frg-apps.json. It currently seeds known Tailnet-only FRG surfaces:

• clawdad
• cmail
• dumpy
• song-dossier
• trading-dashboard

frg context --json is the preferred machine-readable entrypoint for Codex and other agents.

Fresh Machine Setup

Use frg doctor to inspect the current machine. It reports the active Node runtime, available global package managers, available Node version managers, and FRG tools such as Codex, Tailscale, and Git.

Node comes first on a new machine. Node provides npm; npm installs this package; then frg setup codex installs or upgrades Codex CLI.

frg bootstrap --json
frg doctor
frg doctor --json
frg setup
frg setup --json
frg setup codex --dry-run
frg setup codex

Development

npm test
node ./bin/frg.js apps list
node ./bin/frg.js context --json