Skip to content
Famasi Agents

CLI

Live

@famasi/agents is Famasi’s command-line tool for provider setup. It adds instruction files for your coding agent, links your provider and checks your setup.

To connect an app, use the steps in Choose your app. You don’t need this tool for that.

install

Adds Famasi’s instructions for your agent to the current project.

Terminal window
npx @famasi/agents@latest install claude-code

The targets are claude-code, codex, openclaw and generic-mcp.

Options:

  • --stage waitlist records your interest on the waitlist instead of installing.
  • --mcp-url <url> sets a different address. The default is https://mcp.famasi.ai/mcp.
  • --provider-api-key <key> passes your key for this install. It isn’t saved unless you also use the next option.
  • --persist-secrets saves your key in .mcp.json as plain text. Avoid this, and never commit that file.

Files created:

TargetFiles
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

Codex doesn’t read .mcp.json, so also follow the Codex steps. The same goes for OpenClaw, where the install only adds a skill file.

Links this project to your provider.

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

Options:

  • --provider-id <id> is required.
  • --provider-name <name> sets a display name.
  • --mcp-url <url> sets a different address. The default is https://mcp.famasi.ai/mcp.

See Provider API keys.

doctor

Checks your setup: what’s installed, your provider link, your settings, required environment variables and any placeholder values left to fill in.

Terminal window
npx @famasi/agents@latest doctor

scaffold openai-ts

Creates a starter TypeScript project using the OpenAI SDK, set up for Famasi.

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

Environment variables

VariablePurpose
FAMASI_PROVIDER_API_KEYYour provider API key
FAMASI_MCP_URLA different address to use. The default is https://mcp.famasi.ai/mcp.
FAMASI_AGENTS_STAGEwaitlist to join the waitlist instead of installing
FAMASI_WAITLIST_ENDPOINTOptional waitlist submission address