Getting StartedInstallation

Installation

CLI

Install the factory CLI globally from npm:

 add -g @notation/factory-cli

The CLI runs on Bun, which must be on your PATH.

Packages

In your infrastructure repository, add @notation/factory and the plugins factory.infra.ts uses:

 add -d @notation/factory @notation/factory-cloudflare @notation/factory-github @notation/factory-claude

In each outpost repository, add @notation/factory and the plugins .factory/infra.ts uses:

 add -d @notation/factory @notation/factory-github @notation/factory-claude

Prerequisites

Some plugins need a vendor CLI on your machine, signed in:

PluginRequiresSign in
@notation/factory-githubghgh auth login
@notation/factory-claudeclaude, for the CLAUDE_CODE_OAUTH_TOKEN its Account readsclaude setup-token
@notation/factory-cursoragent, for the CURSOR_API_KEY its Account readsAn API key from the Cursor dashboard
@notation/factory-droiddroid, for the FACTORY_API_KEY its Account readsAn API key from the Factory settings page
@notation/factory-cloudflarenpx wrangler@4npx wrangler login
@notation/factory-railwayrailway, for factory container ssh and resumerailway login