CLI reference — Foundry

install

Install one reusable Foundry skill and MCP connection for Codex, Cursor, and Claude Code.

npx foundry-design install

Options --agent codex,cursor,claude · --yes

Install or update Foundry, repair the detected shared agent connection, validate the integration, and start or resume the visual session.

npx foundry-design

Options --project PATH · --url URL · --new · --no-open · --no-dev · --no-start · --yes

Migrate legacy project agent files and refresh the shared connection to one exact release while preserving customized files.

npx foundry-design reset

Options --project PATH · --agent codex,cursor,claude · --url URL · --yes

Show locally installed agents and recently opened projects without using an account or telemetry.

npx foundry-design companion

Options --json

Connect the project through the shared machine bridge and configure only its supported development integration.

npx foundry-design setup --yes

Options --project PATH · --agent codex,cursor,claude · --agent none · --project-agent · --url URL · --yes

Start the loopback runtime, reuse or launch the project preview, and open an authenticated Foundry session.

npx foundry-design start

Options --project PATH · --url URL · --platform PLATFORM · --new · --no-open · --no-dev

Check project detection, instrumentation, agent connection, preview availability, and runtime health.

npx foundry-design doctor

Options --project PATH · --repair · --json

Report project integration, the installed MCP version, runtime health, and the live listener as separate readiness checks.

npx foundry-design status

Options --project PATH · --json

Inspect the project and output its local design graph for components, variants, tokens, and source mappings.

npx foundry-design index

Options --project PATH · --output FILE

Export a session as structured JSON, one agent prompt, or the complete local record.

npx foundry-design export <SESSION_ID>

Options --format json|prompt|full · --output FILE

Add one reusable user-level skill and MCP connection for a coding agent.

npx foundry-design install-agent <cursor|claude|codex>

Options --project-agent · --project PATH

Remove the current project from Foundry's recent-project list without deleting its development adapter.

npx foundry-design disconnect

Options --project PATH · --yes

Remove Foundry-managed project integration while preserving files that contain user changes.

npx foundry-design uninstall

Options --project PATH · --global · --agent codex,cursor,claude · --yes