# Codex

Set up Rungsmith in Codex and build native Perspective interfaces from your project.

## Before you start

Hosted read-only endpoint. It serves the same reviewed registry used by the website. Keep your local Perspective project and Gateway available to your agent.

Connect Codex to the hosted endpoint. Keep your Perspective project available to the agent.

The skill installer requires Node.js 20 or later. For connection problems, follow MCP troubleshooting.

[Check the MCP connection](/docs/mcp#troubleshooting)

## 1. Add the MCP server

Run this command in your terminal.

Terminal

```shell
codex mcp add rungsmith --url https://www.rungsmith.dev/api/mcp
```

## 2. Confirm the connection

Terminal

```shell
codex mcp list
```

Ask the agent to call list_components. A list of registered native components confirms the connection. This preview does not ask you to sign in.

## 3. Install the skill

From your project folder, run the installer for your operating system.

Windows · PowerShell or Command Prompt

```shell
curl.exe -fsSL https://www.rungsmith.dev/api/skills/install | node --input-type=module - --client codex --url https://www.rungsmith.dev
```

macOS / Linux · terminal

```shell
curl -fsSL https://www.rungsmith.dev/api/skills/install | node --input-type=module - --client codex --url https://www.rungsmith.dev
```

Destination: .agents/skills/rungsmith-perspective/. Reload your agent after installation. If you prefer the ZIP, extract its rungsmith-perspective folder into this location.

[Download skill ZIP](/api/skills/rungsmith-perspective)

## Build with Rungsmith

Example request

```text
Use Rungsmith to add a pump status and an operator action to my Perspective view. Find the components, read their parameters and dependencies, then adapt them to my project.
```

The agent reads your local project with its own tools. Rungsmith supplies the catalog and documentation; the hosted MCP cannot inspect your local Gateway.

[Free and Pro access](/docs/mcp#plans)

[How the skill works](/docs/agent-skills)