Connect an agent - Rippletide Documentation

Connect an existing agent to Rippletide to see its prompts, tools, and live runtime evidence. Once connected, you can define rules for the actions it takes.

Start with a coding agent (recommended)

In Agents & integrations, select Connect → Agent.
Save the generated .env block in the root of your agent repository. It contains the agent ID and Connection key; the setup prompt contains no credentials.
Give the setup prompt to Codex, Claude Code, or your preferred coding agent.
Run your agent and send one message that uses a tool.

The setup prompt installs rippletide-package, declares your agent’s prompts and tools, and adds the scripts needed to sync the inventory and send runtime evidence.

Or start with the CLI

npm install -g rippletide-package
rippletide login
cd your-agent-repo
rippletide connect
rippletide status

rippletide connect prepares the binding, writes the .env block, syncs your inventory, and starts the runtime worker. Use rippletide status to check your progress.

Verify the connection

Your agent is ready when Rippletide shows:

its prompts and tools in Harness management;
a heartbeat and a real turn in Runtime events.

Connection secret values are never uploaded. Rippletide only records the names of configured secrets. Need to install the SDK yourself? Follow the manual setup.