### Start the Relay Project

Source: https://github.com/emanuele-web04/remodex/blob/main/relay/README.md

Commands to navigate to the relay directory, install dependencies, and start the relay server.

```sh
cd relay
npm install
npm start
```

--------------------------------

### Start the bridge process manually

Source: https://github.com/emanuele-web04/remodex/blob/main/CONTRIBUTING.md

Installs dependencies and starts the bridge process in the phodex-bridge directory with a specific relay endpoint.

```sh
cd phodex-bridge
npm install
REMODEX_RELAY="ws://localhost:9000/relay" npm start
```

--------------------------------

### Clone and run local Remodex setup

Source: https://github.com/emanuele-web04/remodex/blob/main/SELF_HOSTING_MODEL.md

Clone the public Remodex repository and start the local LAN pairing flow using the run-local-remodex.sh script. This is the recommended first step for most GitHub users.

```sh
git clone https://github.com/Emanuele-web04/remodex.git
cd remodex
./run-local-remodex.sh
```

--------------------------------

### Start the relay on the VPS

Source: https://github.com/emanuele-web04/remodex/blob/main/Docs/self-hosting.md

Clone the repository and start the relay service on your VPS. By default, the relay listens on port 9000.

```sh
git clone https://github.com/Emanuele-web04/remodex.git
cd remodex/relay
npm install
npm start
```

--------------------------------

### Cursor CLI Command Examples

Source: https://github.com/emanuele-web04/remodex/blob/main/Docs/cursor-cli-sdk-acp-integration.md

Examples of invoking the Cursor agent via the CLI. The command name may vary based on the installed version.

```bash
cursor-agent -p "Implement the requested change" --output-format stream-json
```

```bash
agent -p "Implement the requested change" --output-format stream-json
```

--------------------------------

### Start bridge from source

Source: https://github.com/emanuele-web04/remodex/blob/main/Docs/self-hosting.md

Run the bridge from the source directory with the relay URL configured.

```sh
cd phodex-bridge
npm install
REMODEX_RELAY="wss://relay.example.com/relay" npm start
```

--------------------------------

### Start phodex-bridge service

Source: https://github.com/emanuele-web04/remodex/blob/main/AGENTS.md

Commands to navigate to the phodex-bridge directory and initiate the service.

```bash
cd phodex-bridge
npm start
```

--------------------------------

### Agent creation and prompt

Source: https://github.com/emanuele-web04/remodex/blob/main/Docs/cursor-cli-sdk-acp-integration.md

Conceptual example of creating a Cursor agent and sending a prompt using the SDK.

```javascript
const { Agent, Cursor } = await loadCursorSdk()

const agent = await Agent.create({
  model: { id: rawModelId },
})

const result = await agent.prompt(prompt)
```

--------------------------------

### Clone and start local relay and bridge

Source: https://github.com/emanuele-web04/remodex/blob/main/CONTRIBUTING.md

Clones the repository and executes the local launcher script to start the relay and bridge processes.

```sh
# Clone the repo
git clone https://github.com/Emanuele-web04/remodex.git
cd remodex

# Start a local relay + bridge together
./run-local-remodex.sh
```

--------------------------------

### Verify CLI Capabilities

Source: https://github.com/emanuele-web04/remodex/blob/main/Docs/cursor-cli-sdk-acp-integration.md

Commands to check the help documentation for the installed CLI version.

```bash
cursor-agent --help
agent --help
```

--------------------------------

### Start Remodex CLI-managed daemon

Source: https://github.com/emanuele-web04/remodex/blob/main/Docs/multi-provider-standalone-architecture.md

Starts the local bridge, secure pairing state, runtime adapter, and the Codex or OpenCode runtime using the CLI.

```bash
remodex up
```

--------------------------------

### Cursor Model Options

Source: https://github.com/emanuele-web04/remodex/blob/main/Docs/cursor-cli-sdk-acp-integration.md

Examples of provider-qualified model strings for Cursor.

```text
cursor:composer-latest
cursor:auto
cursor:<raw-model-id>
```

--------------------------------

### Check and perform Codex CLI login

Source: https://github.com/emanuele-web04/remodex/blob/main/README.md

Check that the Codex CLI is authenticated before starting the bridge. Remodex expects the local Codex CLI to be installed and authenticated; it does not manage OpenAI credentials.

```sh
codex login status
codex login
```

--------------------------------

### Install or update remodex bridge globally

Source: https://github.com/emanuele-web04/remodex/blob/main/README.md

Installs the Remodex bridge globally from npm with the latest version. Use this to install or update the bridge. After updating, run `remodex restart` if the macOS background service is installed.

```sh
npm install -g remodex@latest
```

--------------------------------

### LaunchAgent Kickstart Logic

Source: https://github.com/emanuele-web04/remodex/blob/main/plans/001-prevent-launchagent-restart-loops.md

Checks for the existence of the plist file and kickstarts the LaunchAgent if it exists.

```js
const plistPath = resolveLaunchAgentPlistPath({ env, osImpl });
if (!fsImpl.existsSync(plistPath)) {
  return startMacOSBridgeService({ /* ... */ });
}
// ...
kickstartLaunchAgent({ env, execFileSyncImpl, plistPath });
```

--------------------------------

### Open the iOS project

Source: https://github.com/emanuele-web04/remodex/blob/main/CONTRIBUTING.md

Navigates to the iOS project directory and opens the Xcode project file.

```sh
cd CodexMobile
open CodexMobile.xcodeproj
```