Installation & Commands

The @famasi/agents CLI provides installation, configuration, and diagnostic tools.

install <target>

Install Famasi Agents for a specific platform.

npx @famasi/agents@latest install claude-code
npx @famasi/agents@latest install codex
npx @famasi/agents@latest install openclaw
npx @famasi/agents@latest install generic-mcp

Options:

--stage <stage> — Use specific rollout stage (waitlist or v1)
--provider-api-key <key> — Set API key during install

Files created per target:

Target	Files
`claude-code`	`.mcp.json`, `.claude/agents/famasi-provider.md`, `.claude/commands/famasi-link-provider.md`
`codex`	`.mcp.json`, `.famasi/skills/codex/famasi-provider/SKILL.md`, `AGENTS.md`
`openclaw`	`.famasi/skills/openclaw/famasi-patient/SKILL.md`
`generic-mcp`	`.mcp.json`

link provider

Authenticate as a provider.

npx @famasi/agents@latest link provider --provider-id YOUR_PROVIDER_ID

Options:

--provider-id <id> — (required) Your Famasi provider ID
--provider-name <name> — Optional display name
--mcp-url <url> — Override default MCP URL

Full authentication details →

doctor

Diagnose installation state.

npx @famasi/agents@latest doctor

Checks:

Installation status for each target
Authentication state
Configuration values
Required environment variables
Placeholder values that need updating

scaffold openai-ts

Scaffold a new OpenAI TypeScript project.

npx @famasi/agents@latest scaffold openai-ts [destination]

Creates a starter project with TypeScript config, OpenAI SDK setup, and Famasi MCP integration template.

Environment variables

Variable	Purpose
`FAMASI_PROVIDER_API_KEY`	Your provider API key
`FAMASI_AGENTS_STAGE`	Rollout stage (`waitlist` or `v1`)
`FAMASI_WAITLIST_ENDPOINT`	Optional waitlist submission endpoint

Staged rollout

The CLI uses a two-stage rollout:

Waitlist (default) — Captures intent, directs to waitlist page
v1 — Full installation with real installers

To use v1:

FAMASI_AGENTS_STAGE=v1 npx @famasi/agents@latest install claude-code

Or:

npx @famasi/agents@latest install claude-code --stage v1