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 packages list
frg packages show <id>
frg packages registry --json
frg bootstrap --json
frg doctor [--json]
frg setup [--json]
frg setup suite [--dry-run|--json]
frg setup <package-id> [--dry-run|--json]
frg setup orp [--dry-run|--json]
frg setup codex [--dry-run|--json]
frg context --json

Registry

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

• clawdad
• cmail
• dumpy

The package registry lives at registry/frg-packages.json. The setup wizard uses this suite definition:

• open-research-protocol / orp: research workflow, governance, hygiene, secrets, and artifact protocol layer.
• @openai/codex / codex: Codex CLI agent used by the FRG workflow stack.
• clawdad / clawdad: multi-agent orchestration for persistent coding agents and delegated work.
• lifeops / lifeops, cmail: agenda composition, communications, and local coordination.
• dumpy-files / dumpy-files: local-first artifact/file handoff.
• read-docs / read-docs: macOS document reading, dictation, and speech workspace.
• solo-founder / founder: business/founder workflow package for workshop packaging and founder operations.

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 suite installs or upgrades Open Research Protocol, Codex CLI, Clawdad, LifeOps/CMAIL, Dumpy Files, Read Docs, and Solo Founder.

frg bootstrap --json
frg doctor
frg doctor --json
frg setup
frg setup --json
frg packages list
frg packages show clawdad
frg setup suite --dry-run
frg setup suite
frg setup orp --dry-run
frg setup orp
frg setup codex --dry-run
frg setup codex

Development

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